开发环境搭建-3：配置 nodejs 开发环境 (fnm+ node + pnpm)

在 WSL 环境中配置：WSL2 (2.3.26.0) + Oracle Linux 8.7 官方镜像

node 官网：https://nodejs.org/zh-cn/download

点击【下载】，选择想要的 node 版本、操作系统、node 版本管理器、npm包管理器

根据下面代码提示依次执行对应代码即可

基本概念说明

1. nodejs = 可以脱离浏览器在本地运行 js 代码的环境 = JS 解析器 + 一套用于与外部交互的底层接口（如网络、文件、存储等） 2. node 版本管理器：允许一台电脑上安装多个不同版本的 nodejs --> 类比：使用 conda 或 uv 管理一台电脑上安装的多个 python 版本 3. node 版本：当前使用版本管理器安装的版本与 Linux 系统版本类似，有 LTS 版本和普通版本 4. npm 包：js 中软件包的格式 --> 类比：python 中的 pip 包 5. npm 包管理器：管理 npm 包的工具 --> 类比：python 中的 pip

根据官网给出的安装教程安装

选取上面的组件，官网给出的代码（请以官网代码为准，这里只是做个参考）

总体安装顺序：nodeJS 管理器 --> 特定版本的 NodeJS --> 包管理器

# 1. 下载并安装 node 管理器，这里安装 fnm
#    Download and install fnm:
curl -o- https://fnm.vercel.app/install | bash

# 2. 更新 bash 终端，使 fnm 命令可用
source $HOME/.bashrc

# 2. 使用 node 管理器安装特定版本的 nodejs
#    Download and install Node.js:
fnm install 22

# 3. 检验 node 是否安装成功
#    Verify the Node.js version:
node -v # Should print "v22.13.1".

# 4. 安装选定的 npm 包管理器，这里选 pnpm
#    实际上在 node 20 以后，node 自带了一个 corepack 插件用于管理 npm 包管理器
#    Download and install pnpm:
corepack enable pnpm

# 5. 检验 npm 包管理器是否安装正常
#    Verify pnpm version:
pnpm -v

第一步（下载并安装 node 管理器）安装过程中需要系统安装有curl、unzip软件
1. 如果没有安装会报 Missing 然后退出（以下是有 curl 但是缺少 unzip 的情况）
2. 使用以下指令安装（以 WSL Oracle Linux 系统为例）

sudo dnf install unzip curl

如果在 fnm install 和 corepack enable pnpm 时很慢，则可能是因为网络问题，需要配置梯子
1. 也可配置 fnm 的代理和 corepack 的代理

一些配置

配置 fnm 国内镜像加速

使用清华源，参考配置：[https://mirrors.tuna.tsinghua.edu.cn/help/nodejs-release/](https://mirrors.tuna.tsinghua.edu.cn/help/nodejs-release/)

官网配置是临时配置，重启/重新登录会失效

永久配置，修改用户环境配置文件

# 1. 打开文件
vim ~/.bashrc

# 2. 文件最后添加以下内容
export FNM_NODE_DIST_MIRROR="https://mirrors.tuna.tsinghua.edu.cn/nodejs-release/"

# 3. 保存文件

# 4. 更新配置文件
source ~/.bashrc

# 5. 之后就可以正常使用 fnm 了

配置 corepack 的国内镜像加速

根据官网文档进行配置：[https://github.com/nodejs/corepack?tab=readme-ov-file#environment-variables](https://github.com/nodejs/corepack?tab=readme-ov-file#environment-variables)

配置COREPACK_NPM_REGISTRY环境变量，指定从国内源中下载 npm 包管理器

临时配置：直接在终端输入export命令

export COREPACK_NPM_REGISTRY ="<软件源路径>"

# 示例：使用腾讯源的路径
export COREPACK_NPM_REGISTRY="https://mirrors.cloud.tencent.com/npm/"

永久配置：将export指令放到/root/.bashrc配置文件中，并刷新配置

# 1. 用文本编辑器打开 /root/.bashrc 配置文件
vim ~/.bashrc

# 2. 添加这一行：将临时的指令固化为永久配置
# 配置示例参考上面的【临时配置】
export COREPACK_NPM_REGISTRY="<软件源路径>"

# 3. 文件保存退出

# 4. 刷新刚才修改的配置文件，使修改生效
source /root/.bashrc

pnpm 初始化配置

使用`pnpm setup`进行初始化设置

pnpm setup

执行完成的结果示例

执行完成后，需要依照执行结果，更新 bash（就是运行上面截图最后一行的指令 source XXX）

配置 pnpm 的国内镜像加速（使用 mrn 管理）

参考文章：[https://ksh7.com/posts/npm-registry](https://ksh7.com/posts/npm-registry)

使用 mrn 这个 npm 包进行镜像加速，这里配置的是阿里淘宝源

查看默认配置

pnpm config list

可看到软件源registry是国外的官网

使用包管理器（pnpm）安装nvm包

pnpm add -g nrm

如果遇到 Unable to find the global bin directory（无法找到全局软件包路径）这种问题

请参考上面的章节，先进行 pnpm 的初始化

安装成功示例（最后有个 Done，其中间没有 ERROR 提示）

运行nrm进行换源，相关指令

帮助：mrn -h
查看当前使用的源：nrm current
查看当前可替换的源：nrm ls
设置当前使用的源：nvm use 源名称
下面截图以taobao源为例