企业官网建设流程全解析

前言

Node.js 几乎是现代前端和后端开发绕不开的运行时环境。但很多新手在安装配置时容易踩坑——比如装完了命令行里却找不到node、全局模块装完不知道去哪了、npm 下载慢得像蜗牛，等等。

本文将带你从零开始，完成 Node.js 在 Windows 上的安装、环境配置、镜像加速，以及常见问题的排查与解决。

一、什么是 Node.js

简单说，Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时，让你能在浏览器之外跑 JS 代码。

装好 Node.js 之后你会同时获得两个命令行工具：

• node— 运行 JavaScript 的运行时

• npm— Node 包管理器，用来安装第三方库

二、下载安装包

版本选择

去 Node.js 官网 会看到两个版本：

截至 2026 年 6 月，推荐下载v22.x LTS。

国内镜像加速下载

官网下载在国内有时候很慢，可以用国内镜像：

• 阿里云镜像：CNPM Binaries Mirror

• 腾讯云镜像：Index of /nodejs-release/

• 华为云镜像：Index of nodejs-local

选对应的大版本号（如v22.20.0/），下载node-v22.20.0-x64.msi或node-v22.20.0-x64.zip。

推荐下.msi安装包，图形化界面一路点就行。

三、安装步骤

3.1 运行安装程序

双击下载好的.msi文件，进入安装向导。

3.2 接受许可协议

勾选 "I accept the terms in the License Agreement"，点 Next。

3.3 选择安装路径

重点：不要用默认的 C 盘路径。

默认路径是C:\Program Files\nodejs\，建议改到其他盘，比如：

D:\NodeJs\Node

这样做的好处：重装系统不怕丢、路径好记、方便排查问题。

3.4 选择安装组件

这里一般保持默认就行，所有组件都选中。特别注意：

• npm package manager— 必装

• Add to PATH— 必选，否则装完系统找不到 node 命令

3.5 自动安装工具（可选）

安装到最后一步会弹出一个复选框，问你要不要自动安装 Chocolatey 等额外工具。

勾掉，不需要。直接点 Finish 完成安装。

四、验证安装

打开一个新的 PowerShell 或 CMD 窗口，依次输入：

node --version

预期输出类似：

v22.20.0

再验证 npm：

npm --version

预期输出类似：

10.9.0

如果两个命令都能正常输出版本号，说明安装成功了。

五、配置 npm

5.1 修改全局模块安装路径

npm 默认把全局模块装在 C 盘，C 盘空间宝贵，建议改到其他盘。

在 Node.js 安装目录（比如D:\NodeJs\Node）下新建两个文件夹：

D:\NodeJs\Node\node_global ← 全局模块 D:\NodeJs\Node\node_cache ← 缓存

创建完毕后，复制刚刚创建的【node_global】和【node_cache】文件夹路径在cmd命令分别输入以下两条命令，注意不要两条命令的文件路径不要搞混了。

注：可以打开所创建的文件夹，把鼠标放在箭头指向的位置选择复制。

使用管理员身份打开cmd命令窗口，输入以下命令（下面的路径是我创建的文件夹所在的路径，需要复制你们自己创建的路径哦）

然后在命令行里设置：

#npm config set prefix “你的路径\node_global” #（复制刚刚所创建的“node_global”文件夹路径） npm config set prefix "D:\NodeJs\Node\node_global" #npm config set cache “你的路径\node_cache” #（复制刚刚所创建的“node_cache”文件夹路径） npm config set cache "D:\NodeJs\Node\node_cache"

5.2 把新的 global 路径加入 PATH

不然后续用npm install -g xxx装的全局命令会找不到。

打开"环境变量" → 在系统变量Path中：

1. 把原来的D:\NodeJs\Node\node_global之前的 npm 默认路径删掉（如果有的话），添加一条新记录：D:\NodeJs\Node\node_global(将默认的 C 盘下【AppData\Roaming\npm】修改成 【node_global】的路径)

2. 在【系统变量】中选择【Path】点击【编辑】后点击新建【%NODE_PATH%】

顺便把D:\NodeJs\Node也确认在 PATH 里。

5.3 配置淘宝镜像（国内必备）

npm 默认去registry.npmjs.org拉包，国内下载容易超时或极慢。换成国内镜像：

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

验证是否生效：

npm config get registry

应该输出https://registry.npmmirror.com。

如果想装cnpm命令行工具也可以（非必需）：

npm install -g cnpm --registry=https://registry.npmmirror.com

六、常见问题与解决

6.1 安装后 node 命令找不到

现象：

'node' 不是内部或外部命令，也不是可运行的程序

排查步骤：

1. 确认D:\NodeJs\Node已加入系统 PATH

2. 关掉当前命令行窗口，新开一个再试（环境变量不会自动刷新）

3. 如果还不行，重启电脑

6.2 能找到 node 但无法运行

现象：

程序"node"无法运行: 找不到应用程序所在位置

或者用where.exe node看到输出类似：

C:\Windows\System32\node ← 一个假文件排在前面 D:\NodeJs\Node\node.exe ← 真正的 node

原因：C:\Windows\System32里有一个叫node的 0 字节空文件（可能是某个程序卸载后的残留，或 Windows 应用执行别名），它在 PATH 中的搜索优先级比你装的 Node 高。

解决：用管理员 PowerShell 删掉它：

Remove-Item C:\Windows\System32\node -Force

6.3 npm 全局安装的包找不到命令

现象：比如执行npm install -g yarn成功，但敲yarn报找不到命令。

原因：npm 全局模块目录没在 PATH 里。

解决：确认D:\NodeJs\Node\node_global已加入系统 PATH。

6.4 npm install 报权限错误（Error: EPERM）

现象：

Error: EPERM: operation not permitted

解决：用管理员身份打开命令行再执行，或者前面已经配置了把全局路径改到 D 盘的话一般不会遇到这个问题。

6.5 安装时提示 2502 / 2503 错误

现象：运行.msi安装包时报 2502 或 2503 错误。

解决：用管理员身份运行安装包。右键.msi文件 → 以管理员身份运行。或者用管理员 CMD 执行：

msiexec /package "你下载的安装包路径.msi"

七、版本管理工具（进阶）

如果你需要在不同项目间切换 Node.js 版本，可以考虑装一个版本管理器：

• nvm-windows：https://github.com/coreybutler/nvm-windows

• fnm：https://github.com/Schniz/fnm （跨平台，更快）

装好 nvm 后可以自由切换版本：

nvm install 22.20.0 # 安装指定版本 nvm use 22.20.0 # 切换到指定版本 nvm list # 查看已安装的版本

总结

步骤不复杂，记住几个关键点：

1. 去官网下 LTS 版本，网速慢就用国内镜像

2. 安装路径别放 C 盘，记得勾选 "Add to PATH"

3. 装完改 npm 的全局路径和缓存路径到非 C 盘

4. 国内用户一定要配淘宝镜像，不然下载等到天荒地老

5. 遇到node命令诡异报错，先where.exe node排查是不是被假文件劫持了