温馨提示×

Ubuntu中Node.js依赖如何安装

小樊
45
2025-10-18 05:09:51
栏目: 编程语言

在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.jsondependencies字段:

npm install express --save # 安装Express框架(生产依赖) 

或简写为:

npm i express 

安装开发依赖(仅开发阶段使用)

若依赖仅用于开发(如代码检查、测试工具),添加--save-dev参数,将依赖添加到package.jsondevDependencies字段:

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依赖的安装与管理。根据项目需求选择合适的安装方式,能有效提升开发效率。

0