Debian上JS库安装有哪些技巧

Debian 上 JS 库安装技巧

一 基础准备与版本选择

• 使用系统仓库快速起步：在 Debian 上可先通过 apt 安装 Node.js 与 npm，命令为：sudo apt update && sudo apt install nodejs npm；安装后用 node --version、npm --version 校验版本。适合稳定环境或 CI 场景。
• 需要特定 Node.js 版本时，优先用 NodeSource 仓库安装，例如安装 16.x：curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -，随后 sudo apt install -y nodejs。
• 多项目并行或需切换版本时，使用 nvm（Node Version Manager）：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash，然后 nvm install 16.13.2、nvm use 16.13.2；用 nvm alias default <version> 设置默认版本，避免干扰系统全局环境。

二 包管理器选择与安装方式

• 使用 npm（Node 默认）：本地安装 npm install <pkg>；生产依赖写入 package.json 用 npm install <pkg> --save；开发依赖用 npm install <pkg> --save-dev；全局工具（如 CLI）用 sudo npm install -g <pkg>（全局安装更便于命令行直接使用）。
• 使用 Yarn：适合对安装速度与可重复性有要求的项目。安装后执行 yarn add <pkg>、yarn add -D <pkg>、yarn remove <pkg>、yarn upgrade <pkg> 等，依赖解析与缓存机制通常更快更稳。
• 使用 pnpm：以节省磁盘空间与提升安装速度为特色，采用符号链接的 node_modules 结构，适合大型仓库与 monorepo。

三 项目依赖管理最佳实践

• 始终在项目根目录维护 package.json：新增依赖时优先使用 --save 或 --save-dev，确保团队成员与 CI 能一键还原环境（npm install 或 yarn install）。
• 区分环境依赖：运行时依赖用 --save，构建/测试工具用 --save-dev，避免把开发工具打进生产镜像。
• 锁定版本与可复现构建：提交 package-lock.json 或 yarn.lock，并在部署时以锁文件为准，减少“在我机器上能跑”的问题。
• 升级策略：小步升级、回归测试；优先使用 npm update <pkg> 或 yarn upgrade <pkg> 而非盲目改版本号，降低破坏性变更风险。

四 系统级与全局安装的取舍

• 全局安装（-g）适合 CLI 工具（如 typescript、eslint、nodemon），便于在任意目录调用；但应用代码依赖建议一律本地安装，纳入版本控制与锁文件管理。
• 若遇到系统自带的 Node.js/npm 版本过旧，优先用 NodeSource 或 nvm 获取合适版本，再按项目选择本地或全局安装策略。

五 常见问题与快速排查

• 权限问题：全局安装需要管理员权限，使用 sudo npm install -g <pkg>；更推荐用 nvm 将 Node 安装到用户目录，避免 sudo 与全局污染。
• 版本不匹配：不同项目需要不同 Node.js 时，用 nvm 隔离；必要时设置默认版本 nvm alias default <version>。
• 依赖冲突与不一致：删除 node_modules 与锁文件后重装，或使用 npm ci / yarn install --frozen-lockfile 确保与锁文件一致。
• 网络与镜像：在受限网络环境下，可配置 npm 或 Yarn 使用国内镜像源，提高安装成功率与速度。