在 Ubuntu 上安装和管理 Node.js 依赖
一 准备环境
- 更新系统并安装基础工具：
- sudo apt update && sudo apt upgrade
- sudo apt install -y build-essential g++ curl libssl-dev
- 安装 Node.js 与 npm（两种常用方式，择一）：
- 使用系统仓库（版本通常较旧但稳定）：
- sudo apt install -y nodejs npm
- 使用 NodeSource 安装指定版本（推荐，版本更新）：
- 选择版本号（如：20.x、22.x），以 22.x 为例：
- curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
- sudo apt-get install -y nodejs
- 验证安装：
- node --version
- npm --version
说明：NodeSource 脚本会添加官方 APT 源并导入 GPG 密钥，便于后续通过 apt 管理 Node.js。
二 使用 npm 安装项目依赖
- 进入项目目录并初始化（如已有 package.json 可跳过）：
- cd /path/to/project
- npm init -y
- 安装生产依赖：
- npm install 包名
- 或显式写入生产依赖：npm install 包名 --save
- 安装开发依赖：
- npm install 包名 --save-dev
- 全局安装 CLI 工具（可选）：
- 常用管理命令：
- 更新：npm update 包名（或 npm update 更新全部可更新项）
- 卸载：npm uninstall 包名
- 安装 package.json 中全部依赖：npm install
提示：使用 --save 或 --save-dev 会将依赖写入 package.json，便于团队协作与 CI/CD。
三 使用 Yarn 或 pnpm（可选）
- Yarn：
- 安装：sudo apt install yarn 或 npm install -g yarn
- 使用：
- 初始化：yarn init -y
- 安装：yarn add 包名；开发依赖：yarn add -D 包名
- 更新：yarn up 包名；卸载：yarn remove 包名
- pnpm：
- 安装：npm install -g pnpm
- 使用：
- 初始化：pnpm init
- 安装：pnpm add 包名；开发依赖：pnpm add -D 包名
- 更新：pnpm up 包名；卸载：pnpm rm 包名
说明：Yarn 与 pnpm 与 npm 命令风格相近，pnpm 以节省磁盘空间见长。
四 常见问题与建议
- 权限问题：
- 避免用 sudo npm install -g；推荐使用 Node 版本管理器（如 nvm）或在用户目录安装，以获得无需 sudo 的全局包管理。
- 版本选择：
- 若项目对版本敏感，优先使用 NodeSource 安装所需 LTS 版本，保持开发与生产一致。
- 锁文件与一致性：
- 使用 npm 时会生成/更新 package-lock.json；使用 yarn 使用 yarn.lock；使用 pnpm 使用 pnpm-lock.yaml。提交锁文件到版本控制，确保依赖一致性。
- 本地与全局：
- 项目依赖尽量本地安装（不加 -g）；全局仅用于 CLI 工具（如 typescript、eslint、nodemon 等）。
