Node.js安装与环境配置全攻略（2023最新版）

为什么你的Node.js总是装不好？（新手必看坑点）

每次教新人装Node.js都发现：80%的问题都出在环境配置上！！！（特别是Windows用户）今天我们就用最接地气的方式，手把手带你避开那些隐藏大坑！

---

一、安装前的灵魂三问（超级重要）

1. 你的系统是32位还是64位？
   （别笑！真有人装错版本！）在Windows上按Win+R输入dxdiag就能看到。Mac用户直接无脑选64位就行～

2. 需要安装旧版本吗？
   如果是接手老项目，强烈建议用nvm（Node Version Manager）。但今天我们先搞定基础安装！

3. 杀毒软件关了吗？
   特别是某60安全卫士，经常拦截安装进程！（亲身血泪教训）

---

二、手把手安装教学（多平台演示）

▶ Windows篇

1. 官网下载地址：https://nodejs.org
   （认准LTS版本！别装Current版，除非你想当小白鼠）

2. 双击安装包后注意这个界面：
   
   一定要勾选Automatically install the necessary tools！（自动装Python和C++编译工具）

3. 安装完成后：

   # 打开CMD验证
   node -v
   npm -v
   

   如果出现版本号→恭喜！如果报错→看第四章常见问题

▶ Mac篇

推荐使用Homebrew安装（没有brew？先运行这个）：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

然后一行命令搞定：

brew install node

（Mac用户就是可以任性～）

▶ 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 nodejs

---

三、环境配置的三大神技（效率翻倍！）

1. 镜像加速（告别npm timeout）

# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com

# 临时使用
npm install --registry=https://registry.npmmirror.com

2. 全局安装路径修改（避免C盘爆炸）

# 新建全局安装目录
mkdir D:\node_global
mkdir D:\node_cache

# 配置npm
npm config set prefix "D:\node_global"
npm config set cache "D:\node_cache"

# 最后把D:\node_global加入系统PATH！

3. 必备工具安装

npm install -g yarn pnpm nodemon nrm

（这些工具能让你的开发效率飞起来～）

---

四、常见报错急救指南（收藏备用！）

❌ ‘node’ 不是内部或外部命令

说明PATH没配置好！检查：

1. 安装时是否勾选了"Add to PATH"
2. 手动添加Node安装目录到环境变量

❌ npm ERR! code EPERM

权限问题！试试：

# Windows用管理员打开CMD
# Mac/Linux前加sudo
sudo npm install -g xxx

❌ Python not found

需要安装Python 2.7（注意是2.7不是3.x！）和Visual Studio Build Tools

---

五、升级的正确姿势（别再用npm更新npm了！）

推荐神器nvm-windows（Windows）和n（Mac/Linux）：

# 使用n管理版本
npm install -g n
n lts  # 安装最新LTS版
n latest  # 安装最新版

---

六、终极验证：创建你的第一个Node程序

1. 新建hello.js：

const http = require('http');
http.createServer((req, res) => {
  res.end('Hello Node.js!');
}).listen(3000);

2. 运行：

node hello.js

3. 浏览器打开http://localhost:3000
   看到欢迎语→环境配置成功！（可以发朋友圈炫耀了～）

---

最后的小贴士（老司机经验）

1. 项目尽量用yarn或pnpm替代npm（依赖管理更稳）
2. 学会看错误日志！90%的问题在报错信息里都有线索
3. 遇到玄学问题→删除node_modules重新install
4. 定期运行npm outdated查看过期依赖

现在你已经超越了80%的Node.js新手！接下来可以愉快地搞事情了～（记得遇到问题先Google，实在不行再问人）