Node.js安装及环境配置教程

安装前确认版本、架构与用途

如果你已经获得安装器但未完成环境配置，本页的目标是让node与npm命令都能返回版本。需要准备Windows、安装器和本机写入权限。

先从Node.js下载页获取并核对在线安装器。本页对应的软件管家版本记录为16.17.0.0，后续包名带有x86线索。Node.js 16已经EOL，不适合作为新生产项目的默认版本；如果项目没有锁定旧版本，应先查看LTS版本选择。

查看Windows的“系统类型”，确认操作系统架构，再结合项目要求选择安装包。64位Windows通常能运行部分32位程序，但原生扩展、内存上限和工具链可能受到影响。维护旧项目时不要只看系统能否启动，还要确认依赖是否支持目标Node版本与架构。

安装前关闭正在占用旧Node目录的终端和开发服务器，但不必关闭全部安全防护。保留项目代码、package.json和锁文件；如果电脑已有Node.js，先记录where node、node --version和npm --version的结果，便于安装后对比。

按顺序完成Windows安装

1. 1.双击已核验的安装器，确认系统弹出的文件名与来源符合预期。
2. 2.阅读许可与目标目录，不要把运行时安装到临时下载目录或项目内部。
3. 3.保留Node.js运行时、npm和PATH相关组件；若向导显示额外原生工具选项，按项目是否需要编译原生模块决定，不必为普通脚本盲目安装整套工具链。
4. 4.完成安装后关闭向导，退出所有旧终端窗口。
5. 5.打开新的PowerShell或命令提示符，再执行版本和路径检查。

这组操作覆盖核对来源与版本、运行安装器、保留PATH相关组件、完成安装、重开终端以及验证node和npm路径。常见失败点包括旧终端、PATH未刷新、x86与x64选择、旧版本残留和Node 16 EOL边界。

安装目录本身可以自定义，但团队环境应保持可记录、可维护。路径中包含特殊权限或被安全策略限制的位置，可能造成全局包写入和升级问题。普通项目依赖应安装在项目目录，不要依赖管理员权限把所有包全局安装。

验证node、npm与实际路径

node --version
npm --version
where node
where npm

前两条命令应分别返回Node.js和npm版本，后两条命令用于确认终端命中的可执行文件位置。where node若出现多个结果，Windows通常优先使用PATH中靠前的位置；这可能造成安装了新版本却仍运行旧版本。where npm通常会指向与Node.js同一安装体系中的脚本文件。

再创建一个空目录和app.js，写入console.log(process.version)，运行node app.js。如果输出版本与node --version一致，说明终端、脚本文件和运行时已形成最小闭环。仅有npm命令而node命令异常，或两者来自不同目录，都需要先修复路径再安装项目依赖。

PATH为什么安装后没有立即生效

环境变量由进程启动时读取。安装前已经打开的终端、编辑器和开发服务器不会自动刷新PATH，所以第一步应是完全关闭旧窗口并重新打开。不要一看到“不是内部或外部命令”就重复安装。

如果新终端仍找不到命令，打开Windows环境变量设置，检查PATH中是否存在实际Node.js安装目录。只添加目录，不要把node.exe文件名直接写入PATH。修改前记录原值，一次只调整一项；删除重复项时确认没有项目或版本管理器依赖它。

使用nvm等版本管理器时，PATH通常由工具管理。手工固定另一个Node目录可能破坏切换逻辑。此时先查看版本管理器状态和where node结果，不要同时用独立安装器与版本管理器争夺同一个命令。

旧版本与旧Windows的边界

软件管家原始系统字段为Win10/Win8/Win7/WinS2008/Vista/WinXP/WinS2003。这是历史记录，不是当前支持承诺。

安装记录如何留存

可复查的安装记录应同时包含时间、文件、目录、版本和命令结果。这样能够区分安装器问题、环境变量问题与项目自身问题，也方便团队比较不同电脑的状态。

把安装日期、安装目录、node --version、npm --version和where node结果记录到项目说明中。团队成员遇到差异时可以先对照这些信息，而不是从头猜测。对于服务项目，还应记录运行账户、启动命令和环境变量来源，确保重启或迁移后能复现同一环境。

“完成Windows安装、PATH生效和node与npm命令验证”是这套流程的完整结果。只有向导结束但命令不可用，仍然属于环境配置未完成。

软件管家记录列出Win10、Win8、Win7等系统字段，这是历史分发信息，不是2026年的兼容或安全承诺。Node.js 16已停止上游维护，旧Windows本身也可能停止安全更新。生产服务、联网工具和涉及敏感数据的脚本，应使用仍受支持的操作系统与Node.js版本。

旧项目如果必须继续运行Node 16，应限制暴露面、锁定依赖、保留可重建环境，并制定迁移计划。先在测试环境升级，运行自动化测试，再检查原生扩展、TLS连接、构建工具和部署脚本。不要把“程序能启动”当作“版本仍安全”。

安装成功后的下一步

安装验证通过后应立即运行一个最小脚本，再决定是否引入第三方依赖。这样可以把运行时本身与后续项目配置分开，减少排错时的变量数量。

完成版本与路径验证后，进入Node.js入门教程运行第一个脚本。需要第三方包时学习npm install，先在项目目录初始化package.json，再安装本地依赖。遇到命令、PATH或多版本异常时，按Node与npm问题排查从轻到重检查。