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

variablevoyager

于 2025-05-16 18:19:40 发布

阅读量1.6k

点赞数 30

CC 4.0 BY-SA版权

文章标签： node.js 其他

本文链接：https://blog.youkuaiyun.com/variablevoyager/article/details/148013617

一、为什么要学Node.js？（别再说它是前端专属了！）

最近有个学Java的哥们问我：“Node.js不是前端的东西吗？我们后端为啥要学？” 我当场就笑出了声！（敲黑板）Node.js本质是JavaScript运行时环境，重点在"运行时"三个字啊朋友们！

举个栗子🌰：你现在要开发一个电商系统，用Java写后台服务没问题。但如果要实时监控用户行为数据呢？用Node.js处理高并发的I/O操作简直爽到飞起！现在很多大厂（阿里、腾讯、美团）都在用Node做中间层，这波车不上真的血亏！

二、安装前的灵魂三问

1. Windows/Mac/Linux都适用吗？

必须的！Node.js是跨平台的扛把子选手，不过不同系统安装姿势略有不同（后面细说）

2. 需要先装JDK吗？

不需要！！！（重要的事情三个感叹号）Node.js自带V8引擎，解压即用真香警告！

3. 版本怎么选？

LTS版：长期支持版（推荐新手）
Current版：尝鲜版（适合老司机）

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

三、手把手安装教学（含避坑指南）

Windows用户看这里👇

官网下载地址：https://nodejs.org
双击安装包时：
- ✅ 勾选"Automatically install…"（自动装必要工具）
- ❌ 不要改安装路径！默认C盘最稳妥
安装完成后：
按Win+R输入cmd打开命令行
```
node -v
npm -v
```
看到版本号说明成功！（没有的话重启试试）

Mac用户专属通道🍎

强烈推荐用Homebrew安装：

# 先安装Homebrew（已有可跳过）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装Node.js
brew install node

如果遇到权限问题：

sudo chown -R $(whoami) /usr/local/*

Linux大神操作指南🐧

Ubuntu/Debian系：

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

CentOS/RedHat系：

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

四、环境配置黑科技（小白秒变大神）

1. npm镜像加速（解决下载慢问题）

# 使用淘宝镜像
npm config set registry https://registry.npmmirror.com

# 验证配置
npm config get registry

2. 全局包安装路径修改（C盘救星！）

# 创建全局安装目录
mkdir ~/npm-global
npm config set prefix '~/npm-global'

# 配置环境变量（Windows用户看系统属性->高级设置）
export PATH=~/npm-global/bin:$PATH

3. 必备工具推荐

nvm（Node版本管理神器）：

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

yarn（更快的包管理器）：
```
npm install -g yarn
```

五、常见问题急救包🚑

问题1：'node’不是内部或外部命令

👉 解决方案：

检查环境变量Path是否包含Node.js安装路径
重启命令行工具
重装时选择"Add to PATH"选项

问题2：EACCES权限错误（常见于Mac/Linux）

# 修复全局包权限
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules

问题3：npm install卡住不动

尝试：

# 清除缓存
npm cache clean --force

# 使用VPN
# 或者换用yarn
yarn install

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

新建hello.js文件：

const http = require('http');
http.createServer((req, res) => {
  res.end('恭喜！Node环境配置成功🎉');
}).listen(3000, () => {
  console.log('服务已启动：http://localhost:3000');
});

运行程序：

node hello.js

浏览器访问http://localhost:3000 看到欢迎信息就算大功告成！

七、升级指南（装完别跑！）

想要保持Node.js最新特性又怕影响现有项目？试试这些姿势：

使用nvm自由切换版本：

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

查看已安装版本：

nvm ls

设置默认版本：

nvm alias default 20.0.0

八、写在最后

最近帮学妹装环境时发现一个坑：某些杀毒软件会拦截Node进程！如果遇到莫名奇妙的运行失败，可以试试暂时关闭杀毒软件（操作完记得重新打开哦~）

Node.js生态现在有多火？看看这些数字：

npm仓库包数量突破200万+
每周下载量超过300亿次
GitHub上Node相关项目占比27%

还在等什么？赶紧动手把你的JavaScript技能扩展到服务端吧！遇到问题欢迎评论区留言，看到必回～