Debian系统js依赖怎么解决

Debian 系统 JavaScript 依赖处理指南

一 基础环境准备

• 更新索引并安装基础运行环境：
  • 命令：sudo apt update && sudo apt install -y nodejs npm
  • 验证：node -v、npm -v
• 若需要特定版本 Node.js，优先使用 NodeSource 仓库（示例为 16.x）：
  • 命令：curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
  • 安装：sudo apt install -y nodejs
• 如需多版本并存与快速切换，使用 NVM（示例版本 v0.39.1）：
  • 安装：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
  • 重载：source ~/.bashrc（或新开终端）
  • 使用：nvm install 16.13.2、nvm use 16.13.2
• 可选：使用 Yarn 作为替代包管理器：
  • 安装：sudo apt install yarn
  • 使用：yarn install、yarn add <package>、yarn upgrade、yarn remove <package>。

二 安装与维护项目依赖

• 初始化项目（若不存在 package.json）：npm init -y
• 安装依赖：
  • 本地安装：npm install <package>（写入 dependencies）
  • 开发依赖：npm install -D <package>（写入 devDependencies）
  • 全局安装：npm install -g <package>
• 按清单安装：npm install（读取 package.json 与 package-lock.json）
• 更新与卸载：
  • 更新：npm update（或 npm update <package>）
  • 卸载：npm uninstall <package>（如需移除全局包加 -g）
• 使用 Yarn 的场景：yarn add <package>、yarn upgrade、yarn remove <package>。

三 版本冲突与兼容处理

• 症状：同时存在多个 Node.js 版本或依赖包不兼容导致安装/运行异常。
• 处理步骤：
  • 使用 NVM 隔离版本：
    • 查看远程版本：nvm ls-remote
    • 安装与切换：nvm install 14.18.0、nvm use 14.18.0
  • 若曾用 NodeSource 安装过旧版本，先彻底清理再装新版本：
    • 清理：sudo apt-get remove --purge nodejs npm
    • 重装：按第二节添加对应 NodeSource 仓库后 sudo apt-get install -y nodejs
  • 针对依赖报错，锁定与当前 Node.js 兼容的版本（例如：npm install <package>@x.y.z）。

四 国内网络与全局目录优化

• 提升下载速度（中国大陆常用镜像）：
  • 设置镜像：npm config set registry https://registry.npm.taobao.org
• 自定义 npm 全局包 目录（避免权限与污染系统目录）：
  • 创建目录：mkdir ~/.npm-global
  • 配置前缀：npm config set prefix '~/.npm-global'
  • 写入环境变量（例如 ~/.bashrc 或 ~/.zshrc）：export PATH=~/.npm-global/bin:$PATH
  • 使生效：source ~/.bashrc。

五 生产环境建议

• 进程守护：使用 PM2 管理 Node.js 进程
  • 安装：sudo npm install -g pm2
  • 常用：pm2 start server.js、pm2 list、pm2 logs、pm2 restart server.js
• 反向代理：使用 Nginx 暴露服务
  • 安装：sudo apt install nginx
  • 配置示例：将请求代理到 http://localhost:3000，然后 sudo nginx -t && sudo systemctl reload nginx
• 安全与维护：
  • 使用 .npmrc 管理私有源与作用域包
  • 定期更新依赖并审计安全：npm audit、npm outdated，必要时使用 npm ci 在 CI 环境快速复现依赖。