最近帮同事配一台 Windows 办公机,项目偏偏锁死了 Node.js v16.13.2。不是不能装新版,而是那套老前端项目一上 Node 18+ 就开始闹脾气,webpack 编译报错、node-sass 二进制对不上,最后只能老老实实回到 v16.13.2 这条线。本来以为装个旧版本是件简单事,结果发现这台机器之前残留了另一个版本的 Node,命令行里 node -v 输出的根本不是目标版本,排查起来比想象中费劲。
这篇内容说的就是 Node.js v16.13.2 在 Windows 上的安装和环境配置。它会讲清楚为什么有些项目非要锁定这么老的版本、安装前需要确认哪些信息、MSI 安装每一步怎么处理、环境变量到底怎么配才算真正生效,以及安装完之后的验证方式。同时也会覆盖 npm 源配置、和 Vue 项目配合时常见的坑、卸载报 2053 这类问题的处理思路。比较适合刚接触前端、第一次在 Windows 上搭 Node 环境的开发者,也适合那些被历史项目锁住版本、被迫“考古”的运维和前端同学参考。
1. 先想清楚:为什么偏偏要装 v16.13.2
很多新手上来就问“Node.js 不是装最新版就行吗?”这句话在公司新项目上可能成立,一旦碰到老项目,情况就完全不一样。v16.13.2 不是一个随便写的版本号,它背后是有明确使用场景的。如果不搞清楚这一点,你装完 n 次都会发现事情不对。
1.1 版本选择逻辑:LTS、Active 与 EOL
Node.js 的版本发布节奏里有个非常核心的概念叫 LTS,也就是 Long Term Support,长期维护版本。每个大版本进入 LTS 阶段以后,官方会持续提供 bug 修复和安全更新。v16 是在 2021 年 4 月发布的,同年 10 月 26 日进入 LTS 阶段,而 v16.13.2 正是它进入 LTS 之后的一个补丁版本,发布于 2021 年 12 月左右,随附的 npm 版本是 8.1.2。
这个版本号的“身份”很特殊:它不是开发版 Current,也不是 EOL 之后的废弃版本,而是处于 LTS 活跃期的稳定补丁版。很多团队在 2021 年底到 2023 年之间初始化项目时,会刻意把 Node 版本锁在 v16.13.2 上,因为这是经过大量线上项目验证过的一个稳定点。
有
