Ubuntu安装Node.js依赖完整指南

在Ubuntu上安装Node.js依赖，操作本身并不复杂，但新手常在版本选择和权限问题上遇到困难。以下从系统准备到项目初始化，再到依赖安装与管理，逐步梳理完整流程。

1. 准备工作：更新系统并安装基础工具

开始安装Node.js前，建议先将Ubuntu的软件包列表更新至最新，避免因系统组件过旧引发兼容性问题。执行以下命令即可：

sudo apt update && sudo apt upgrade -y

若需从源码编译Node.js（通常无需，仅特殊场景需要），则需安装编译工具链：

sudo apt install python build-essential -y

大多数用户可跳过此步，但提前准备无妨。

2. 安装Node.js与npm

Node.js依赖通过npm管理，因此需先确保Node.js和npm均已安装。推荐以下三种方式，可根据场景选择。

方式一：Ubuntu官方APT仓库（简单，适合快速搭建）

sudo apt install nodejs npm -y

安装后运行版本检查，确认满足项目要求（如Node.js ≥14.x）：

node -v
npm -v

优点是无脑快，缺点是官方仓库版本通常较旧。

方式二：NodeSource仓库（推荐，获取最新稳定版）

若官方仓库版本过旧，NodeSource提供APT仓库，可安装指定版本。以LTS版18.x为例：

# 先卸载旧版本（如有）
sudo apt remove --purge nodejs npm -y
# 导入GPG密钥并添加仓库
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
# 安装Node.js（自带npm）
sudo apt install -y nodejs
# 验证版本
node -v   # 应输出 v18.x.x
npm -v    # 对应npm版本

这种方式既稳定又能获取较新版本，是多数场景的首选。

方式三：NVM安装多版本（灵活，适合开发测试）

若需在同一台机器上切换多个Node.js版本（如同时维护不同项目），可使用NVM（Node Version Manager）。

# 安装NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc    # 使NVM生效
# 安装最新LTS版本
nvm install --lts
# 验证
node -v   # 输出最新LTS版本，如v20.x.x
npm -v

NVM的最大优势是“版本随需切换”，nvm use <版本>即可完成，开发调试非常方便。

3. 初始化Node.js项目（创建package.json）

package.json是项目的“身份证”，记录依赖信息和元数据。进入项目目录，执行以下命令：

cd /path/to/your/project
npm init -y   # 快速生成默认package.json

加-y参数使用全部默认值，省时省力。如需自定义项目名称、版本等信息，去掉-y，按提示逐步填写即可。

4. 安装项目依赖

安装生产依赖（项目运行必需）

使用npm install安装依赖时，默认会写入package.json的dependencies字段。例如安装Express框架：

npm install express --save

或简写：

npm i express

两者效果相同，日常使用简写即可。

安装开发依赖（仅开发阶段使用）

部分工具仅在开发时使用（如代码检查、自动重启），需加--save-dev参数，写入devDependencies字段：

npm install eslint --save-dev   # 代码检查工具
npm install nodemon --save-dev  # 开发时自动重启服务

这样打包发布时，生产环境不会包含这些非必要组件。

5. 其他常用依赖管理命令

• 更新依赖：升级指定依赖到最新版

npm update express

• 删除依赖：移除依赖并从package.json中删除

npm uninstall express

• 全局安装：将依赖安装到系统全局，供所有项目使用（如命令行工具）

npm install -g typescript   # 全局安装TypeScript编译器

注意事项

• 权限问题：安装时若报权限错误，加sudo可临时解决，但不推荐长期使用。更优做法是通过npm config set prefix ~/.npm-global配置全局安装路径，彻底避免sudo。
• 版本兼容性：确保Node.js版本满足项目要求（如某些依赖仅支持Node.js 16+），使用nvm切换版本最为便捷。
• 缓存清理：安装速度慢或失败时，可清空npm缓存后再试：

npm cache clean --force

完成以上步骤，Ubuntu上Node.js依赖的管理便基本覆盖全面。根据项目需求选择最合适的安装方式，开发效率自然提升。