Ubuntu系统Node.js工具使用详解

Ubuntu环境下Node.js工具的使用指南

先说一个核心结论：在Ubuntu系统上使用Node.js开发时，工具链的选择和安装方式，很大程度上决定了后续开发的效率与体验。很多新手容易被多种安装方法搞乱，实际上无非几种主流路径，只要理解了底层原理，剩下的操作就很简单了。

1. 安装Node.js工具

在正式动手之前，需要先安装Node.js运行环境和npm（包管理器）。常见安装方式有以下几种，我们逐一讲解最实用的方案。

1.1 使用APT仓库安装（简单快捷）

这个方法最省事，打开终端直接执行命令即可。适合希望快速上手体验的用户。

# 更新系统软件包列表
sudo apt update
# 安装Node.js（包含npm）
sudo apt install nodejs npm -y
# 验证安装（显示版本号即为成功）
node -v
# 示例输出：v18.16.0
npm -v
# 示例输出：10.4.0

1.2 使用NodeSource PPA安装（推荐，支持最新版本）

如果你需要较新的版本（例如18.x），官方提供的PPA源是理想选择。它可以避免Ubuntu默认仓库版本滞后的麻烦。

# 导入NodeSource GPG密钥并添加APT仓库
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
# 安装Node.js
sudo apt install -y nodejs
# 验证安装（同上）
node -v
npm -v

1.3 使用NVM（Node Version Manager）安装（灵活管理多版本）

如果你需要在不同项目间频繁切换Node版本（例如一个项目用18，另一个用16），NVM就是最佳解决方案。它就像一个版本切换器，灵活度极高。

# 安装NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
# 激活NVM（重新加载shell配置）
source ~/.bashrc
# 安装指定版本的Node.js（如18.16.0）
nvm install 18.16.0
# 切换至该版本
nvm use 18.16.0
# 验证安装
node -v

1.4 配置npm环境（可选）

安装完成后，有两个值得顺手完成的配置，可以避免权限问题和网络延迟。

设置全局安装路径

默认全局安装会涉及系统目录权限问题，不如直接安装到用户目录下，既清爽又安全。

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
# 将路径添加至~/.bashrc
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

更换镜像源

国内用户应该都明白，使用淘宝镜像能显著加快下载速度。

npm config set registry https://registry.npmmirror.com/

2. 常用工具命令

工具安装完成后，接下来就是日常开发中高频使用的命令。以下这些操作，在Node.js项目里会反复用到。

2.1 npm（包管理）

初始化项目 npm init -y可以快速生成默认的package.json，但更建议手动填写关键字段，让项目元数据更清晰规范。

npm init -y

安装依赖

npm install lodash
# 安装lodash至项目依赖
npm install express --sa ve
# 安装express（生产依赖）
npm install eslint --sa ve-dev
# 安装eslint（开发依赖）

区别很简单：--sa ve是生产环境运行所需，--sa ve-dev仅用于开发阶段。

运行脚本

在package.json的scripts字段中定义好命令，启动方式一目了然。

// package.json示例
"scripts": {
 "start": "node app.js",
 "dev": "nodemon app.js"
}

npm start
# 启动应用（对应"start"脚本）
npm run dev
# 启动开发模式（对应"dev"脚本）

2.2 node（运行应用）

执行JS文件

node app.js

REPL环境：输入node进入交互式环境，直接运行代码测试小片段非常便捷。

node
> console.log("Hello Node.js!");
// 输出：Hello Node.js!

2.3 nodemon（开发辅助）

这个工具堪称开发时的得力助手——修改代码后它会自动重启应用，无需手动退出再启动。

npm install -g nodemon
nodemon app.js
# 修改app.js后，nodemon会自动重启应用

2.4 pm2（进程管理）

一旦应用需要上线，pm2才是真正的守护神。它负责后台运行、负载均衡、日志管理等多种功能。

npm install -g pm2
pm2 start app.js --name "my-app"
pm2 list
pm2 monit
pm2 stop my-app
pm2 restart my-app

2.5 eslint（代码质量）

代码规范仅靠自觉很难维持。eslint能自动检测语法错误和不一致的编码风格。

npm install -g eslint
eslint --init
eslint app.js
eslint --fix app.js

3. 创建第一个Node.js项目

理论讲解完毕，接下来我们快速搭建一个Express应用，将前面介绍的工具串联起来。

3.1 初始化项目

mkdir my-express-app
cd my-express-app
npm init -y

3.2 安装依赖

npm install express
npm install nodemon --sa ve-dev
# 开发时自动重启

3.3 编写应用代码

创建app.js文件：

const express = require('express');
const app = express();
const port = 3000;

// 定义路由
app.get('/', (req, res) => {
  res.send('Hello from Node.js on Ubuntu!');
});

// 启动服务器
app.listen(port, () => {
  console.log(`Server running at http://localhost:${port}/`);
});

3.4 启动应用

开发阶段使用nodemon，生产环境切换为pm2。

npm run dev
# 或
pm2 start app.js --name "my-express-app"

3.5 访问应用

在浏览器中打开http://localhost:3000，即可看到"Hello from Node.js on Ubuntu!"的欢迎信息。

按照上述流程操作，一个完整的Node.js开发环境就能在Ubuntu上顺利搭建完成。后续如果需要添加数据库、模板引擎等，无非就是通过npm install安装依赖并编写代码。工具链只是起点，真正的乐趣在于项目"跑起来"之后。