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 Package Manager）安装，因此需先确保两者已正确安装。推荐以下两种方式：

方式一：通过Ubuntu官方APT仓库安装（简单，适合快速搭建环境）

sudo apt install nodejs npm -y

安装完成后，验证版本（需满足项目要求，如Node.js ≥14.x）：

node -v  # 查看Node.js版本
npm -v   # 查看npm版本

方式二：通过NodeSource仓库安装特定版本（推荐，获取最新稳定版）

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

# 移除旧版本（若有）
sudo apt remove --purge nodejs npm -y

# 导入NodeSource 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   # 应输出对应版本

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

若需在同一台机器上切换多个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

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

package.json是项目的核心配置文件，用于记录依赖信息、项目元数据等。在项目目录下运行以下命令：

cd /path/to/your/project  # 进入项目目录
npm init -y               # 快速生成默认package.json（无需手动填写信息）

若需自定义配置（如项目名称、版本），可省略-y参数，按提示逐步填写。

4. 安装项目依赖

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

使用npm install命令安装依赖时，添加--save参数（默认行为，可省略），将依赖添加到package.json的dependencies字段：

npm install express --save  # 安装Express框架（生产依赖）

或简写为：

npm i express

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

若依赖仅用于开发（如代码检查、测试工具），添加--save-dev参数，将依赖添加到package.json的devDependencies字段：

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

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

更新依赖：升级指定依赖到最新版本
```
npm update express
```
删除依赖：移除指定依赖，并从package.json中删除
```
npm uninstall express
```
全局安装依赖：将依赖安装到系统全局（如命令行工具），供所有项目使用
```
npm install -g typescript  # 安装TypeScript编译器（全局）
```

注意事项

权限问题：若安装过程中出现权限错误，可添加sudo提升权限（不推荐长期使用），或通过npm config set prefix ~/.npm-global配置全局安装路径。
版本兼容性：确保Node.js版本符合项目要求（如某些依赖仅支持Node.js 16+），可通过nvm切换版本。
缓存清理：若安装缓慢或失败，可清理npm缓存后重试：
```
npm cache clean --force
```

通过以上步骤，即可在Ubuntu系统中完成Node.js依赖的安装与管理。根据项目需求选择合适的安装方式，能有效提升开发效率。