Debian下JavaScript库如何管理

Debian下JavaScript库管理实践

一 管理思路与工具选择

• 面向Node.js 开发：优先使用npm或Yarn进行依赖管理，配合package.json / yarn.lock进行版本锁定与协作；如需多版本并存与隔离，使用nvm管理 Node 运行时。
• 面向系统级/前端静态资源：可使用apt安装部分通用 JS 运行时或工具（如 nodejs），但应用依赖建议仍以项目级包管理器为主，避免与系统包产生冲突。

二 安装与版本管理

• 使用系统仓库安装 Node.js 与 npm（稳定但版本可能偏旧）
  • 更新索引并安装：sudo apt update && sudo apt install nodejs npm
  • 验证版本：node -v、npm -v
• 使用 NodeSource 获取更新版本
  • 示例（按需选择版本）：curl -fsSL https://deb.nodesource.com/setup_14.x | sudo -E bash -
  • 安装：sudo apt-get install -y nodejs
• 使用 nvm 管理多版本 Node.js
  • 安装 nvm：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
  • 加载 nvm：在 ~/.bashrc 或 ~/.zshrc 中加入
    • export NVM_DIR=“$([ -z “${XDG_CONFIG_HOME-}” ] && printf %s “${HOME}/.nvm” || printf %s “${XDG_CONFIG_HOME}/nvm”)”
    • [ -s “$NVM_DIR/nvm.sh” ] && . “$NVM_DIR/nvm.sh”
  • 使用：nvm install node、nvm use node、nvm alias default node
• 安装 Yarn
  • 方式一（npm 全局）：npm install --global yarn
  • 方式二（APT 仓库，Debian/Ubuntu）：
    • 导入密钥并添加源：
      • curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
      • echo “deb https://dl.yarnpkg.com/debian/ stable main” | sudo tee /etc/apt/sources.list.d/yarn.list
    • 安装：sudo apt update && sudo apt install yarn
    • 若使用 nvm，可避免再装 Node：sudo apt install --no-install-recommends yarn
  • 注意：部分系统存在命令名差异（node 与 nodejs），可在 shell 配置中添加别名：alias node=nodejs。

三 项目级依赖管理常用命令

• npm 常用
  • 初始化：npm init -y
  • 安装依赖：npm install ；生产依赖：npm install --save；开发依赖：npm install --save-dev
  • 全局安装：npm install -g
  • 卸载：npm uninstall ；更新：npm update
  • 查看已装：npm list --depth=0
• Yarn 常用
  • 初始化：yarn init -y
  • 安装依赖：yarn add ；开发依赖：yarn add --dev
  • 全局安装：yarn global add
  • 卸载：yarn remove ；更新：yarn upgrade
  • 查看已装：yarn list
• 版本锁定与协作
  • npm 使用 package-lock.json；Yarn 使用 yarn.lock，提交到版本控制以确保一致性。

四 系统级与项目级依赖的取舍

• 建议将应用依赖放入项目本地（node_modules），通过 npm/yarn 管理；全局安装仅用于命令行工具（如构建、脚手架）。
• 使用 nvm 可为不同项目提供独立的 Node.js 版本，避免全局版本冲突。
• 若通过 apt 安装了系统级 nodejs/npm/yarn，仍应优先在项目内使用本地包管理器，减少与系统仓库包之间的相互影响。

五 常见问题与排错要点

• 命令未找到或命令名不一致
  • 确认 nvm 已加载（重开终端或执行 source 对应脚本），必要时添加别名：alias node=nodejs。
• Yarn 安装时报错或找不到 node
  • 使用 –no-install-recommends yarn 搭配 nvm；或确保系统存在 node 命令（可用别名解决）。
• 依赖冲突与版本漂移
  • 统一团队使用 npm 或 Yarn，提交并锁定 package-lock.json / yarn.lock；避免混用。
• 升级 Node 后本地依赖异常
  • 在项目目录执行：npm install 或 yarn install 重新安装；必要时清理 node_modules 与锁文件后重装。