Debian Node.js 如何进行版本控制

Debian 上 Node.js 版本控制实践

一 推荐方案 NVM 与 volta

• 使用 NVM（Node Version Manager） 在同一台机器上安装、切换多个 Node.js 版本，基于修改 PATH 实现环境隔离，通常无需 sudo，适合开发与多项目并行。常用命令：安装 nvm（示例版本 v0.39.1）后，nvm install 18、nvm use 18、nvm ls、nvm alias default 18；在项目根目录放置 .nvmrc 并使用 nvm use 自动切换版本。
• 使用 volta（现代工具管理器）统一管理 Node.js/npm 等工具链，支持按项目固定版本。常用命令：volta install node@18、volta pin node@18、volta list。
• 二者对比要点：NVM 侧重多版本灵活切换与环境隔离；volta 侧重跨项目与团队协作的一致性与可重复性。

二 系统级安装 NodeSource 仓库

• 适合需要系统级、统一版本的场景（如生产服务器）。步骤：先清理旧版本（可选）sudo apt-get remove --purge nodejs && sudo apt-get autoremove；安装依赖 sudo apt-get update && sudo apt-get install -y curl software-properties-common；添加 NodeSource 仓库（以 18.x 为例）curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -；安装 sudo apt-get install -y nodejs；验证 node -v、npm -v。如需其他版本，将 setup_18.x 替换为 setup_16.x/20.x 等。

三 项目级版本锁定与协作

• 在项目中固定运行时版本：创建 .nvmrc（如写入 18.17.0 或 lts/*），团队成员进入项目目录执行 nvm use 即可对齐版本；或在 package.json 声明引擎范围："engines": { "node": ">=18.0.0" }，配合 npm install 给出版本不匹配提示。
• 在 CI/CD 中固定版本：例如在 GitHub Actions 使用 actions/setup-node 指定版本；在 Jenkins 使用 NodeJS Plugin 选择版本，确保构建与本地一致。

四 多版本切换与日常维护

• 常用维护命令速查：
  • NVM：nvm ls-remote（查看可安装版本）、nvm install <version>、nvm use <version>、nvm alias default <version>、nvm current（查看当前生效版本）。
  • volta：volta install node@<version>、volta pin node@<version>、volta list。
  • 全局包管理：升级 npm 使用 npm install -g npm@latest；如需使用 n（轻量版本切换器），可 sudo npm install -g n，然后 n 18 切换。
• 实践建议：个人开发优先 NVM/volta；服务器统一交付可用 NodeSource；团队统一在仓库根目录维护 .nvmrc 并在 CI 显式设置版本。