Node.js安装及环境配置全攻略（手把手保姆级教程）

本文链接：https://blog.csdn.net/CodeTribe/article/details/148015054

前言：为什么要学Node.js？

（划重点）这年头前端工程师不会Node.js都不好意思跟人打招呼了！从构建工具到服务端渲染，从前端工程化到全栈开发，Node.js简直就是现代Web开发的瑞士军刀（而且完全免费不用激活的那种）！！！

一、安装前的准备动作

1. 查看你的操作系统版本

按住Win+R输入winver（Windows）或打开终端输入uname -a（Mac/Linux）。特别提醒：32位系统只能装32位版本，但强烈建议升级到64位系统（别问为什么，问就是性能翻倍！）

2. 清理历史残留（超级重要）

遇到过无数同学因为旧版本残留导致安装失败的案例！执行这两个命令保平安：

where node # 查看所有node相关路径
rm -rf /usr/local/{bin/{node,npm},lib/node_modules} # 彻底删除残留

二、正式安装环节（三种姿势任选）

方案A：官网直装法（适合萌新）

访问Node.js官网
看到两个大按钮了吗？建议选左边LTS版（长期支持版更稳定）
双击安装包一路Next（但这里有个坑！后面环境变量配置会讲）

方案B：版本管理神器nvm（老司机必备）

（强烈推荐）这才是专业开发者的正确打开方式！可以随意切换Node版本，妈妈再也不用担心版本冲突啦~

# Mac/Linux安装命令
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash

# Windows用户请访问https://github.com/coreybutler/nvm-windows

安装完成后骚操作：

nvm install 18.16.0 # 安装指定版本
nvm use 16.20.1 # 切换版本
nvm ls # 查看已安装版本

方案C：Docker大法（极客专属）

适合玩容器的大佬，一行命令搞定：

docker run -it node:18-slim # 使用官方镜像

三、环境配置防坑指南

1. PATH配置（新手必看）

安装完成后在终端输入：

node -v
npm -v

如果提示命令找不到，说明环境变量没配好（官网安装包有时候会抽风！）

手动配置路径示例（Windows）：

系统属性 -> 高级 -> 环境变量 -> Path添加：
C:\Program Files\nodejs\

2. npm镜像加速

默认源慢到怀疑人生？试试这些国内镜像：

npm config set registry https://registry.npmmirror.com # 阿里云镜像
# 或者
npm install -g cnpm --registry=https://registry.npmmirror.com # 淘宝定制版

3. 全局模块路径修改

默认全局安装路径在C盘？不想污染系统盘的同学看这里：

npm config set prefix "D:\nodejs\node_global"
npm config set cache "D:\nodejs\node_cache"

（记得要把新路径加入系统环境变量PATH哦！）

四、验证安装成果

来段经典Hello World：

// server.js
const http = require('http');
http.createServer((req, res) => {
  res.writeHead(200, {'Content-Type': 'text/plain'});
  res.end('Hello Node.js!\n');
}).listen(3000);
console.log('Server running at http://localhost:3000/');

运行命令：

node server.js

打开浏览器访问http://localhost:3000，看到欢迎信息就成功啦！

五、常见问题急救包

Q1：安装卡在postinstall不动？

试试：

npm set progress=false # 关闭进度条
npm config set loglevel=http # 查看详细日志

Q2：权限问题（特别是Mac/Linux）

在命令前加sudo？No！更安全的做法：

sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules

Q3：node-sass安装报错？

这是祖传坑王了！终极解决方案：

npm install --save-dev node-sass --unsafe-perm
# 或者
npm config set sass_binary_site=https://npmmirror.com/mirrors/node-sass/

六、进阶配置（装逼必备）

1. 用nrm管理镜像源

npm install -g nrm
nrm ls # 查看可用源
nrm use taobao # 切换源

2. 上TypeScript

npm install -g typescript ts-node
tsc --init # 生成tsconfig.json

3. 性能监控三件套

npm install -g clinic autocannon 0x
# 使用示例
clinic doctor -- node server.js

结语：开启你的Node.js之旅

现在你的开发环境已经是满级神装了！接下来可以：

用Express/Koa搞个Web应用
玩转Electron开发桌面应用
试试NestJS搞企业级开发
探索Deno（Node.js作者新作）

（温馨提示）遇到问题别慌，善用官方文档和Stack Overflow。记住：console.log大法好，debugger永流传！