如何在Ubuntu构建JS项目

在Ubuntu上搭建Ja vaScript项目的开发环境，其实是一套相当成熟的流程。无论你是在构建Node.js后端、React或Vue前端，还是像NestJS这样的全栈框架，核心路径都绕不开环境准备、项目初始化、依赖管理、构建配置、进程管理和部署优化这六个关键环节。下面就把这套流程拆开揉碎了讲清楚。

1. 环境准备：装好Node.js和npm

Ja vaScript项目的基础就是Node.js运行时和npm包管理器。但Ubuntu官方源里的版本通常比较旧，所以更推荐用NVM（Node Version Manager）来安装最新稳定版，这样未来切换版本也方便：

# 安装NVM（需要联网）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash

# 加载NVM环境（重启终端或直接运行下面这行）
source ~/.bashrc

# 安装最新的LTS版Node.js（比如v18）
nvm install --lts

# 验证安装，确认版本号出来
node -v  # 示例输出：v18.17.1
npm -v   # 示例输出：9.6.7

小提示：如果你需要特定版本，比如v16，把命令换成nvm install 16就行。

2. 项目初始化：创建目录与package.json

package.json是整个JS项目的“身份证”和“通讯录”，所有元数据和依赖都靠它来管理。操作很简单：

# 创建项目目录并进去
mkdir my-js-project && cd my-js-project

# 初始化项目，用 -y 参数可以跳过问答直接生成默认配置
npm init -y

这一步会在目录下生成一个package.json文件，里面包含了项目名称、版本号、入口文件路径、依赖列表等基本信息。

3. 依赖管理：装上项目需要的包

根据项目类型来安装依赖，这里要区分两种情况：生产依赖（项目运行时就需要的，默认就是这种）和开发依赖（只在开发阶段用的，需要加--sa ve-dev参数）：

# 安装Express框架（生产依赖，用来搭后端API）
npm install express --sa ve

# 安装ESLint（开发依赖，用来做代码质量检查）
npm install eslint --sa ve-dev

补充一句：如果项目用了TypeScript，就需要安装typescript和@types/node；如果是前端项目，那就装react或vue这些框架依赖。

4. 构建配置：定义脚本与构建工具

在package.json里定义脚本命令，可以把常用的构建、启动等操作简化成一句命令。同时，根据项目需要配置构建工具，比如Webpack或Babel：

{
  "scripts": {
    "start": "node index.js",          // 启动生产环境
    "dev": "nodemon index.js",         // 开发环境，支持自动重启
    "build": "tsc",                    // TypeScript编译（如果有的话）
    "lint": "eslint src/"             // 代码检查
  },
  "devDependencies": {
    "nodemon": "^3.0.0",              // 开发时自动重启工具
    "eslint": "^8.0.0"                // 代码检查工具
  }
}

需要注意的是：如果是React这类前端项目，通常还需要配置Webpack的webpack.config.js，并通过npm run build编译出生产代码；如果是NestJS项目，则要用npm run build把TypeScript编译成Ja vaScript。

5. 进程管理：用PM2让应用保持在线

PM2是Node.js生态里很成熟的进程管理工具，它能实现应用崩溃后自动重启、日志管理，甚至支持集群模式来充分利用多核CPU：

# 全局安装PM2
sudo npm install -g pm2

# 启动应用，假设入口文件是index.js，给它取个名字叫my-js-app
pm2 start index.js --name "my-js-app"

# 查看进程状态，确认应用在运行
pm2 status

# 生成开机自启配置，防止服务器重启后进程丢失
pm2 startup

# 保存当前进程列表（需要在执行pm2 startup之后运行）
pm2 sa ve

常用命令再补充几个：pm2 logs看实时日志，pm2 restart my-js-app重启应用，pm2 stop my-js-app停止应用。

6. 部署优化：配置Nginx反向袋里与防火墙

为了提升安全性和可访问性，通常会用Nginx做反向袋里，把外部请求转发到Node.js应用上，同时配置防火墙开放必要的端口：

# 安装Nginx
sudo apt update && sudo apt install nginx

# 开放HTTP（80端口）和HTTPS（443端口）
sudo ufw allow 'Nginx Full'

# 配置Nginx反向袋里，编辑默认站点配置文件
sudo nano /etc/nginx/sites-a vailable/default

在server块里添加下面的内容（把your-domain.com换成你的服务器IP或域名）：

location / {
    proxy_pass http://localhost:3000;          # 转发到Node.js应用端口
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
}

保存文件后重启Nginx让配置生效：

sudo systemctl restart nginx

如果需要启用HTTPS，可以通过Let's Encrypt免费申请SSL证书，再配置Nginx来支持HTTPS访问。

以上就是一套完整的流程。当然，不同的项目类型（像Next.js、NestJS）可能需要调整个别配置，但核心步骤是统一的。从搭建环境到跑起来再到部署上线，一步步走下来就能顺利交付。