Debian 更新 JS 环境的实用步骤
一 选择更新方式
- 使用 NodeSource 仓库：适合服务器/生产环境，版本可控、与系统包管理器集成，便于固定版本与批量部署。
- 使用 nvm（Node Version Manager）：适合开发环境，支持多版本并存与快速切换，不影响系统全局环境。
- 不建议仅依赖 Debian 官方仓库（版本通常较旧），也不推荐手动编译安装（维护成本高）。
二 通过 NodeSource 更新 Node.js 与 npm（系统级）
- 准备环境并可选清理旧版本：
sudo apt update && sudo apt install -y curl software-properties-common
sudo apt remove --purge nodejs npm # 可选：彻底移除旧版本
sudo apt autoremove
- 添加 NodeSource 仓库（按需选择 18.x、20.x 等 LTS 版本）：
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
- 安装/升级 Node.js（同时提供 npm）：
sudo apt install -y nodejs
- 验证：
node -v
npm -v
- 说明：如需升级到其他主版本，将 setup_18.x 替换为目标版本（如 20.x），重复安装步骤即可。
三 通过 nvm 更新 Node.js 与 npm（用户级）
- 安装 nvm：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
- 使配置生效（或重启终端）：
source ~/.bashrc # 如使用 zsh 则 source ~/.zshrc
- 安装与切换版本：
nvm install node # 安装最新 Node.js
nvm use node # 启用该版本
nvm install 18 # 也可指定 LTS 版本
nvm use 18
- 验证：
node -v
npm -v
- 提示：nvm 安装的 Node.js 与 npm 位于用户目录，互不干扰系统版本，便于多项目多版本共存。
四 仅更新 npm 或管理项目依赖
- 更新 npm（两种常用方式）：
- 使用 npm 自身升级（推荐）：sudo npm install -g npm@latest
- 使用系统包管理器：sudo apt update && sudo apt install --only-upgrade npm
- 验证：npm -v
- 管理项目依赖：
- 使用 npm：npm update（按 package.json 规则升级）、npm install <包名>@latest
- 使用 yarn：npm install -g yarn 后，yarn upgrade 。
五 常见问题与建议
- 多版本并存与切换：开发机优先用 nvm；生产机建议用 NodeSource 固定版本，避免意外升级。
- 升级后兼容性：新版本 Node.js 可能引入语法/特性变更（如 顶级 await），旧项目需按需调整（Babel/转译、依赖升级、测试回归）。
- 全局包路径：若使用 nvm，全局包默认在用户目录；如需统一或避免权限问题，可配置 npm 全局目录到用户可写路径并在 shell 配置中更新 PATH。
