一、环境搭建前的准备工作

1.1 系统兼容性检查

Node.js支持Windows（7+/Server 2012+）、macOS（10.13+）、Linux（x64/ARM）三大主流平台。建议使用64位系统以获得最佳性能，可通过uname -m（Linux/macOS）或systeminfo | find "System Type"（Windows）命令验证系统架构。

1.2 安装包获取渠道

推荐从官方渠道下载安装包：

Node.js官网：https://nodejs.org/
GitHub Release：https://github.com/nodejs/release
国内镜像源（如清华源）：https://mirrors.tuna.tsinghua.edu.cn/nodejs-release/

二、Node.js安装全流程

2.1 Windows系统安装

下载安装包：选择LTS版本（长期支持版），推荐16.x或18.x
自定义安装：
- 勾选”Add to PATH”自动配置环境变量
- 安装Node.js runtime和npm包管理器

验证安装：

node -v  # 应输出v16.x.x或v18.x.x
npm -v   # 应输出8.x.x或更高版本

2.2 macOS系统安装

方案一：官方包安装

下载.pkg安装包
双击运行，按向导完成安装

终端验证：

which node  # 应返回/usr/local/bin/node

方案二：Homebrew安装（推荐）

brew install node

2.3 Linux系统安装

Ubuntu/Debian系：

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS/RHEL系：

curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs

三、npm核心配置与管理

3.1 基础配置操作

# 设置国内镜像源（推荐淘宝源）
npm config set registry https://registry.npmmirror.com
# 查看当前配置
npm config list
# 恢复默认镜像
npm config delete registry

3.2 版本升级策略

全局升级：
```
npm install -g npm@latest
```
项目级锁定：通过package-lock.json确保依赖一致性

3.3 常用管理命令

# 清除缓存
npm cache clean --force
# 查看全局安装包
npm list -g --depth=0
# 卸载全局包
npm uninstall -g <package-name>

四、Yarn安装与配置

4.1 安装方式对比

方式	命令	适用场景
npm安装	`npm install -g yarn`	已安装Node.js的环境
Corepack	`corepack enable`	Node.js 16+内置工具
独立安装包	下载.tar.gz解压配置PATH	离线环境

4.2 镜像源配置

# 设置国内镜像
yarn config set registry https://registry.npmmirror.com
# 生成.yarnrc文件（可选）
echo "registry 'https://registry.npmmirror.com'" >> ~/.yarnrc

4.3 性能优化技巧

启用离线模式：
```
yarn config set offline true
```

并行安装：

yarn install --check-files --frozen-lockfile --network-timeout 100000

缓存管理：

yarn cache dir          # 查看缓存目录
yarn cache clean        # 清除缓存

五、多版本管理方案

5.1 nvm使用指南（推荐）

安装步骤：

# macOS/Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
# Windows（使用nvm-windows）
# 下载地址：https://github.com/coreybutler/nvm-windows/releases

常用命令：

nvm install 18.16.0      # 安装指定版本
nvm use 18.16.0          # 切换版本
nvm alias default 18.16.0 # 设置默认版本

5.2 n使用指南（替代方案）

# 安装n模块
npm install -g n
# 安装最新LTS版本
n lts
# 切换版本
n 18.16.0

六、环境验证与故障排查

6.1 完整验证流程

# 1. 创建测试项目
mkdir node-test && cd node-test
npm init -y
# 2. 安装测试包
npm install lodash
yarn add chalk
# 3. 创建测试脚本
echo "const _ = require('lodash'); console.log(_.chunk(['a','b','c'],2));" > test.js
# 4. 运行测试
node test.js  # 应输出[ [ 'a', 'b' ], [ 'c' ] ]

6.2 常见问题解决方案

问题1：命令未找到

现象：node: command not found
解决：
- 检查PATH环境变量是否包含Node.js安装路径
- Windows：重启终端或系统
- macOS/Linux：执行source ~/.bashrc或source ~/.zshrc

问题2：权限错误

现象：EACCES: permission denied

解决：

使用sudo前添加--unsafe-perm（不推荐）

正确方案：修改npm全局安装目录权限

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.profile
source ~/.profile

问题3：网络超时

现象：Error: connect ETIMEDOUT

解决：

更换镜像源

配置代理：

npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080

七、最佳实践建议

版本锁定：始终提交package-lock.json或yarn.lock到版本控制
依赖清理：定期执行npm prune或yarn autoclean
安全扫描：集成npm audit或yarn audit到CI流程
性能监控：使用time yarn install测量安装耗时
多环境配置：通过.npmrc或.yarnrc文件区分开发/生产环境

通过以上系统化的安装与配置流程，开发者可以构建出稳定、高效的Node.js开发环境。建议每季度检查Node.js官方博客（https://nodejs.org/en/blog/）获取最新LTS版本信息，保持环境与社区生态同步发展。

从零搭建Node.js环境：npm与Yarn的安装与配置指南