Node.js / 系统课时
安装 Node.js 与 npm
安装 Node.js 与 npm
本节完成 Node.js 与 npm 的本机安装,并用命令行确认运行时、包管理器和 PATH 都已生效。完成后,你应能在新终端中直接执行 node 与 npm,并能定位“命令找不到”或版本不一致的问题。
学习目标
- 选择适合学习与项目开发的 Node.js LTS 版本并完成安装。
- 用命令验证 Node.js、npm 与实际可执行文件路径是否正确。
选择 LTS 与安装方式
日常学习和大多数业务项目优先选择官网标记为 LTS 的版本,不必追逐 Current。Node.js 官方安装包会同时安装 npm,因此正常情况下不需要再单独安装 npm;安装前先确认系统架构是 x64 还是 arm64,避免下载错误的二进制。
Windows 可在 Node.js 官方 Download 页面选择 Windows Installer,并按机器架构下载 MSI;安装向导保持默认组件即可。macOS 可选择对应架构的 macOS Installer。Linux 如果后续需要频繁切换版本,更适合直接使用版本管理工具,而不是把系统包管理器里的 Node.js 当作唯一开发版本。
完成安装并验证命令
安装结束后关闭旧终端并重新打开,再执行下面这组命令。它们不依赖项目目录,可直接判断 Node.js、npm 与当前 PATH 是否可用。
node --version
npm --version
node -e "console.log(process.execPath)"预期输出
v<VERSION>
<NPM_VERSION>
<PATH><VERSION>、<NPM_VERSION> 和 <PATH> 会随安装版本、操作系统和安装目录变化。关键是三条命令都能正常返回:第一行带 v 前缀,第二行是 npm 版本号,第三行是当前实际执行的 Node.js 路径。
再做一次最小运行验证,确认不仅“能找到命令”,而且 Node.js 确实能执行 JavaScript。
node -e "console.log(1 + 2)"预期输出
3判断 PATH 是否指向了正确版本
如果电脑曾安装过旧版 Node.js,node --version 正常并不代表调用的是刚装的新版本。Windows 在 PowerShell 或命令提示符中执行 where.exe node,macOS/Linux 执行 command -v node;若返回多个路径,应检查排在最前面的那个是否属于预期安装位置。
实际项目里常见的错误是“安装成功但旧终端仍缓存旧 PATH”。先完全关闭终端、IDE 内置终端和相关开发工具,再重新打开验证。若 node 与 npm 指向不同来源,最稳妥的做法是卸载重复安装,只保留一种安装方式。
处理常见安装失败
出现“node 不是内部或外部命令”或 command not found 时,先确认安装程序已结束,再重开终端;仍失败就检查 PATH 中是否存在 Node.js 安装目录。不要直接手工复制 node.exe 或 npm 文件到系统目录,这会造成后续升级和卸载失控。
如果 Windows 中 node 正常,但 PowerShell 执行 npm 提示脚本执行策略阻止 npm.ps1,可以先运行 npm.cmd --version 判断 npm 本体是否可用;公司设备应遵循组织的 PowerShell 策略,不要为了 npm 全局关闭安全限制。
macOS/Linux 若全局安装 npm 包频繁遇到权限错误,不建议用 sudo npm install -g ... 作为长期方案。更合适的处理是改用用户级版本管理工具,让 Node.js 和全局 npm 包位于用户目录;下一课会直接用这种方式管理多个版本。