在 Debian 上进行 JS 版本管理的核心思路是通过管理 Node.js 运行时 与 包管理器 npm，再配合项目级版本锁定，确保开发与生产环境一致、可复现。
选择 Node.js 版本管理工具
- nvm（Node Version Manager）：最常用，适合在 macOS/Linux 上按项目切换多个 Node.js 版本，命令简洁、生态成熟。
- n：轻量级，基于 npm 全局安装，适合个人开发快速切换版本。
- Volta：由 Rust 编写，支持跨平台，能自动管理 Node.js/npm/yarn/pnpm 的版本，进入项目可自动切换。
- fnm（Fast Node Manager）：同样基于 Rust，速度快，跨平台，支持 .node-version 文件自动切换。
- 若需要系统级统一版本（面向所有用户/服务），可用 NodeSource 的 .deb 仓库安装指定 Node.js 版本。
方法一 使用 nvm 管理 Node.js 与 npm
- 安装 nvm（示例版本：v0.39.5）：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
- 重新加载 shell 配置（或重启终端）：
source ~/.bashrc 或 source ~/.zshrc
- 常用命令：
- 查看远程可安装版本：nvm ls-remote
- 安装指定版本：nvm install 18.17.0（或安装最新 LTS：nvm install --lts）
- 使用版本：nvm use 18.17.0
- 设置默认版本：nvm alias default 18.17.0
- 查看已安装：nvm ls
- 验证：node -v、npm -v
方法二 使用 Volta 管理 Node.js 与工具链
- 安装 Volta：
curl https://get.volta.sh | bash
- 常用命令：
- 安装 Node：volta install node@18
- 固定项目版本：在项目根目录执行 volta pin node@18（生成项目级配置，后续进入目录自动切换）
- 查看已管理工具：volta list
- 特点：跨平台、自动切换、可同时管理 npm/yarn/pnpm。
方法三 使用系统仓库或二进制包安装指定版本
- NodeSource 仓库（适合系统级统一版本）：
- 添加仓库（示例为 16.x）：curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
- 安装：sudo apt-get install -y nodejs
- 验证：node -v、npm -v
- 手动二进制安装（便于精确控制版本与路径）：
- 下载并解压官方 Linux x64 二进制包，移动到如 /usr/local/lib/nodejs
- 配置 PATH：echo ‘export PATH=/usr/local/lib/nodejs/node-vXX.X.X-linux-x64/bin:$PATH’ >> ~/.bashrc
- 使生效：source ~/.bashrc
项目级版本锁定与协作规范
- 使用 nvm：在项目根目录创建 .nvmrc（如：18.17.0 或 lts），配合命令：
- 读取并切换：nvm use（或 nvm install 自动安装后切换）
- 建议设置默认版本：nvm alias default 18.17.0，避免新开终端无版本可用
- 使用 Volta：在项目根目录执行 volta pin node@18，提交生成的配置，保证所有协作者进入目录自动使用相同 Node.js 版本
- 使用 fnm：在项目根目录创建 .node-version（如：18.17.0），进入目录自动切换
- 依赖管理：统一使用 package.json 的 engines 字段声明 Node 范围（如：“engines”: { “node”: “>=18.17.0” }），并在 CI/部署脚本中校验，结合 npm 或 Volta 确保一致