ACORG docs

主题

版本选择说明 ​

如果你没有项目的特殊要求，按本文推荐版本安装即可。不要为了追求最新补丁号而手动拼接完整版本号。

Node.js 怎么选 ​

情况建议
第一次安装 Node.js，没有项目要求Node.js 24 LTS
老项目明确要求 Node.js 22Node.js 22 LTS
项目存在 .nvmrc、.node-version 或 package.json 的 engines.node优先遵循项目要求
需要测试尚未进入 LTS 的新特性再考虑 Current 版本，不作为日常默认版本
不确定应该选什么选择 Node.js 24 LTS

本文中的 24 和 22 表示主版本。版本管理工具会在对应主版本下选择可用的补丁版本，因此通常不需要手动指定类似 24.10.1 的完整版本号。

简单记法： 新项目选 Node.js 24 LTS；旧项目要求 22 就选 Node.js 22 LTS；项目配置优先级最高。

Windows 11 ​

使用 nvm-windows：

powershell
nvm install 24
nvm use 24

node --version
npm --version

如果项目要求 Node.js 22：

powershell
nvm install 22
nvm use 22
node --version

预期会看到 v24.x.x 或 v22.x.x。其中 x 代表具体补丁版本，不需要自行判断。

macOS、Linux 与 WSL2 ​

使用 nvm-sh/nvm：

bash
nvm install 24
nvm use 24
nvm alias default 24

node --version
npm --version

如果项目要求 Node.js 22，把上述命令中的 24 替换为 22。

项目版本优先 ​

开始开发前，按以下顺序检查版本要求：

  1. 项目根目录的 .nvmrc。
  2. 项目根目录的 .node-version。
  3. package.json 中的 engines.node。
  4. CI 配置中的 Node.js 版本。
  5. 都没有指定时，使用 Node.js 24 LTS。

查看当前版本：

bash
node --version
npm --version

如果项目要求的主版本与当前版本不一致，先用 nvm 切换，再安装依赖和运行构建。

参考来源 ​