首页 > 编程语言 >Ubuntu下JS开发环境搭建教程

Ubuntu下JS开发环境搭建教程

来源：互联网 2026-08-01 07:53:10

在Ubuntu系统中搭建JavaScript开发环境，核心步骤是安装Node.js及其包管理器npm，可通过三种途径实现：使用默认仓库、添加NodeSourcePPA仓库或安装nvm版本管理器。推荐配置VSCode作为代码编辑器，并设置npm全局模块安装路径以规避权限问题。按上述步骤操作即可完成环境搭建。

Ubuntu系统搭建Ja vaScript（Node.js）开发环境指南

Ubuntu下JS开发环境搭建教程

长期稳定更新的攒劲资源： >>>点此立即查看<<<

对不少刚接触Linux的开发者来说，在Ubuntu上配置一套顺手的Ja vaScript开发环境，看起来是个小门槛。其实说穿了，核心就两件事：装好Node.js和npm，再配个趁手的编辑器。下面把几种主流方案和避坑要点拆开来讲。

1. 安装Node.js与npm（核心工具）

Node.js，简单说就是让Ja vaScript能在服务器上跑起来的运行环境。而npm呢，是Node.js官方自带的包管理器，负责安装依赖、跑脚本这些脏活累活。Ubuntu下装Node.js，主流方案有三条路，按需选择就好。

方法1：使用默认仓库安装（简单，适合新手）

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

注：默认仓库的版本可能较旧（如Ubuntu 22.04默认安装Node.js 16.x），若需最新稳定版，建议选择方法2或方法3。

方法2：使用NodeSource PPA安装（推荐，获取最新稳定版）

# 安装curl（用于下载脚本）
sudo apt install curl
# 添加NodeSource仓库（以Node.js 20.x为例，可替换为其他版本）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
# 安装Node.js（自动包含npm）
sudo apt install -y nodejs
# 验证安装
node -v
# 示例输出：v20.x.x
npm -v 
# 示例输出：10.x.x

优势：支持安装最新LTS版本（如20.x），且能通过apt upgrade更新。

方法3：使用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
nvm install --lts
# 验证安装
node -v
# 示例输出：v20.x.x
npm -v 
# 示例输出：10.x.x
# 切换版本（如切换到18.x）
nvm use 18

优势：可同时安装多个Node.js版本，通过nvm use 快速切换，适合需要兼容不同项目版本的开发者。

2. 配置开发工具（可选但推荐）

安装代码编辑器（如Visual Studio Code）

VS Code可以说是Ja vaScript开发的标配编辑器了，语法高亮、智能提示、调试功能一应俱全。安装也很简单：

# 导入Microsoft GPG密钥
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
sudo install -o root -g root -m 644 microsoft.gpg /etc/apt/trusted.gpg.d/
# 添加VS Code仓库
sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/vscode stable main" > /etc/apt/sources.list.d/vscode.list'
# 更新包列表并安装VS Code
sudo apt update
sudo apt install code
# 启动VS Code（通过应用菜单或终端运行`code`）

安装后，可在VS Code中安装“ESLint”“Prettier”等扩展，提升代码质量。

配置npm全局模块路径（解决权限问题）

不少新手在安装全局模块（比如nodemon）时，会碰到权限错误。其实一个简单的配置就能解决，不用每次都加sudo：

# 创建全局模块目录
mkdir ~/.npm-global
# 配置npm前缀
npm config set prefix '~/.npm-global'
# 将全局路径添加到环境变量
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
# 重新加载配置
source ~/.bashrc
# 测试安装全局模块（如nodemon）
npm install -g nodemon
nodemon --version
# 示例输出：3.x.x

优势：避免使用sudo安装全局模块，提升安全性。

3. 初始化项目与运行代码

创建项目目录并初始化package.json

# 创建项目目录
mkdir my-js-project
cd my-js-project
# 初始化package.json（自动生成项目元数据）
npm init -y
# 结果：生成package.json文件（包含项目名称、版本、依赖等信息）

运行Ja vaScript文件

# 创建入口文件（如index.js）
echo 'console.log("Hello, Ubuntu JS!");' > index.js
# 使用Node.js运行文件
node index.js
# 输出：Hello, Ubuntu JS!

安装项目依赖（如Express框架）

# 安装Express（Web框架）
npm install express
# 添加到开发依赖（如ESLint）
npm install eslint --sa ve-dev
# 查看依赖列表
npm list

package.json会自动记录依赖，后续可通过npm install一键安装所有依赖。

4. 常见问题解决

问题1：node或npm命令未找到 检查是否将Node.js安装路径（如/usr/bin/node）添加到环境变量PATH中，可通过echo $PATH查看。
问题2：安装全局模块失败 确保有sudo权限，或参考“配置npm全局模块路径”步骤修改配置。
问题3：版本冲突 使用nvm切换Node.js版本，或通过npm install @安装指定版本的依赖。