前言

在前端开发、全栈开发或Node.js后端开发中，Node.js及其包管理工具npm、yarn是不可或缺的基础环境。Node.js提供了JavaScript在服务端的运行能力，npm是全球最大的JavaScript包仓库，yarn则以其高性能和稳定性成为npm的替代方案。本文将系统讲解如何正确安装并配置这三者，覆盖不同操作系统下的操作细节，帮助开发者高效搭建开发环境。

一、Node.js安装指南

1.1 版本选择策略

LTS版本：推荐生产环境使用，提供长期支持（3年），稳定性高，适合企业级项目。例如当前LTS版本为Node.js 18.x。
Current版本：包含最新特性，适合尝鲜或个人项目，但可能存在兼容性问题。
版本对比：通过Node.js官网查看各版本特性，建议初学者从LTS版本开始。

1.2 安装步骤（分系统）

Windows系统

访问Node.js官网，下载Windows Installer（.msi文件）。
双击运行安装程序，勾选“Add to PATH”选项（关键步骤，确保命令行可全局调用node和npm）。
完成安装后，打开命令提示符（cmd），输入node -v和npm -v验证安装。

macOS系统

推荐方法：使用Homebrew安装（需先安装Homebrew）。
```
brew install node
```
替代方法：下载官网的.pkg安装包，双击运行。
验证安装：终端输入node -v和npm -v。

Linux系统（Ubuntu/Debian示例）

使用apt包管理器安装：

sudo apt update
sudo apt install nodejs npm

验证安装：
```
node -v
npm -v
```
注意：Linux发行版可能包含旧版本，建议通过NodeSource仓库安装最新LTS版本。

1.3 安装后验证

终端输入node进入交互式环境，输入console.log('Hello, Node.js!')测试运行。
创建测试文件test.js，内容如下：
```
console.log('Node.js is working!');
```
运行命令node test.js，观察输出。

二、npm安装与配置

2.1 npm的自动安装

npm随Node.js一同安装，无需单独操作。
验证npm版本：npm -v。

2.2 npm配置优化

设置全局安装路径（避免权限问题）

创建全局安装目录：
```
mkdir ~/.npm-global
```
配置npm使用该目录：
```
npm config set prefix '~/.npm-global'
```

更新环境变量（以macOS/Linux为例）：

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

镜像源配置（加速下载）

使用淘宝镜像：

npm config set registry https://registry.npmmirror.com

恢复官方镜像：

npm config set registry https://registry.npmjs.org

2.3 常用npm命令

npm init：初始化项目，生成package.json。
npm install <package>：安装依赖（默认保存到dependencies）。
npm install <package> --save-dev：安装开发依赖（devDependencies）。
npm update：更新所有依赖。
npm uninstall <package>：卸载依赖。

三、yarn安装与配置

3.1 yarn的优势

并行安装，速度更快。
确定性安装（生成yarn.lock文件，确保团队环境一致）。
缓存机制，减少重复下载。

3.2 安装方法

通过npm安装（推荐）

npm install -g yarn

其他系统

macOS（Homebrew）：
```
brew install yarn
```

Linux（Debian/Ubuntu）：

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt update && sudo apt install yarn

3.3 yarn配置

设置镜像源

yarn config set registry https://registry.npmmirror.com

常用命令对比

npm命令	yarn等效命令	功能
`npm install`	`yarn`	安装所有依赖
`npm install <package>`	`yarn add <package>`	安装依赖
`npm uninstall <package>`	`yarn remove <package>`	卸载依赖
`npm run <script>`	`yarn run <script>`	运行脚本

四、常见问题与解决方案

4.1 权限问题

现象：安装全局包时提示EACCES错误。
解决方案：
- 使用nvm（Node Version Manager）管理Node.js版本（推荐）。
- 修改npm全局目录权限（不推荐生产环境使用）：
```
sudo chown -R $(whoami) ~/.npm-global
```

4.2 版本冲突

现象：项目依赖版本与全局版本不一致。
解决方案：
- 使用nvm切换Node.js版本。
- 在项目目录下使用npm install或yarn install安装特定版本依赖。

4.3 网络问题

现象：安装依赖时卡在fetchMetadata。
解决方案：
- 切换npm/yarn镜像源。
- 使用代理工具（如cnpm）。

五、环境管理最佳实践

5.1 使用版本管理工具

nvm（Node Version Manager）：

安装：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash

使用：

nvm install 18.16.0  # 安装指定版本
nvm use 18.16.0      # 切换版本

5.2 项目级依赖管理

始终在项目目录下运行npm install或yarn install。
提交package.json和yarn.lock/package-lock.json到版本控制，但忽略node_modules目录。

5.3 定期更新依赖

使用npm outdated或yarn outdated查看过时依赖。
使用npm update或yarn upgrade更新依赖。

六、总结

通过本文，您已掌握：

Node.js在不同系统下的安装方法。
npm的配置优化与常用命令。
yarn的安装、配置及与npm的命令对比。
常见问题的解决方案与环境管理最佳实践。

建议初学者从LTS版本开始，逐步熟悉npm/yarn的工作流程。对于团队项目，统一使用yarn.lock或package-lock.json确保环境一致性。

如何高效安装Node.js、npm与yarn环境：完整指南与最佳实践

前言