Node.js 开发环境安装与配置

工欲善其事,必先利其器。本章带你从零搭建 Node 开发环境:下载安装、用 nvm 管理多版本、初始化第一个项目、跑通 Hello World,并配置 VS Code 和 nodemon 提升开发效率。整个过程不超过 10 分钟。

1. 下载 LTS 版本

打开 https://nodejs.org/,你会看到两个大按钮:LTS(长期支持版)和 Current(最新版)。新手一律选 LTS——它稳定、兼容性好、生产环境都用它。版本号是偶数(20.x、22.x)的才是 LTS,奇数(21、23)不是。

2. 验证安装

安装完成后,打开终端(Windows 用 PowerShell),输入下面命令确认能识别 node 和 npm:

# 查看 Node 版本(确认安装成功)
node -v
# 输出示例: v20.11.0

# 查看 npm 版本(npm 随 Node 一起装)
npm -v
# 输出示例: 10.2.4

# 进入 Node 交互式环境(REPL),输代码立即看结果
node
> 1 + 2
3
> .exit    # 退出

如果提示 "command not found",说明 PATH 没配好——重启终端,或手动把 Node 的 bin 目录加入系统 PATH。npm 是 Node 的包管理器,会随 Node 一起安装,不用单独装。

3. 用 nvm 管理多版本(强烈推荐)

直接装 Node 的问题是:一台电脑只能有一个版本。但真实开发中,不同项目可能依赖不同 Node 版本(老项目用 14,新项目用 20)。这时就要用 nvm(Node Version Manager)来管理多版本。

先装 nvm(macOS/Linux 一行命令,Windows 用 nvm-windows):

# 用 nvm 安装 LTS(长期支持版,推荐生产用)
nvm install --lts

# 安装指定版本
nvm install 18.19.0

# 切换到某版本
nvm use 20

# 查看本地装了哪些版本
nvm ls

# 设置默认版本(新开终端用这个)
nvm alias default 20

# 不同项目可能依赖不同 Node 版本
# 在项目根目录写 .nvmrc 文件,内容是版本号
#   20.11.0
# 之后在该项目目录直接 nvm use 即可切换

有了 nvm,你可以随时在多个 Node 版本之间切换,互不干扰。这是 Node 开发的标准姿势,比直接装 Node 灵活得多。

4. npm:Node 的"应用商店"

装完 Node 你就自动有了 npm——它是世界上最大的开源软件仓库。每个 Node 项目根目录都有一个 package.json 文件,记录项目信息和它依赖的包。创建一个新项目只需两步:

# 1. 新建项目目录
mkdir my-app && cd my-app

# 2. 初始化 package.json(-y 用默认值,不用一路回车)
npm init -y

# 生成的 package.json 长这样:
# {
#   "name": "my-app",
#   "version": "1.0.0",
#   "main": "index.js",
#   "scripts": { "test": "echo \"no test\" && exit 1" },
#   "dependencies": {}
# }

从这一刻起,你的项目就是一个"Node 包"。package.json 是项目的身份证,后续装的所有依赖都会被记录到这里。node_modules 目录非常庞大,绝对不要提交进 git,把它加进 .gitignore;别人拿到你的代码,直接 npm install 就能根据 package.json 装齐所有依赖。

5. 写第一个程序 Hello World

在项目根目录新建 index.js,输入最简单的代码,然后用 node 命令运行:

// 在项目根目录新建 index.js
console.log("Hello, Node.js!");

// 用 node 命令运行
//   $ node index.js
//   Hello, Node.js!

// 也可以在 package.json 里定义运行脚本
// 然后 npm start 就能跑

注意:Node 程序不是在浏览器里跑,而是在终端里用 node 文件名 执行。这是新手最容易混淆的点——浏览器 Console 跑的是浏览器 JS,Node 是另一个完全独立的运行环境。

6. 用 nodemon 提效

开发时改一行代码就要手动 Ctrl+C 再 node xxx.js 重启,极其低效。nodemon 是个开发神器:它会监听文件变化,你一保存代码它就自动重启服务。装一次,提效一整年。

# 全局安装 nodemon(开发时用,改代码自动重启)
npm install -g nodemon

# 用 nodemon 代替 node 运行
nodemon index.js
# 改完代码自动重启,不用手动 Ctrl+C 再 node xxx

# 或者在 package.json 里配 scripts
// package.json
// "scripts": {
//   "dev": "nodemon index.js",
//   "start": "node index.js"
// }

# 然后用 npm run dev 启动(带热重启)
npm run dev

7. 配置 VS Code

VS Code 是写 Node 的首选编辑器(Microsoft 出品,本身也是用 Node 写的)。装好 VS Code 后,建议做以下配置:

8. 国内用户加速:npm 镜像

默认 npm 源在国外,国内访问慢、容易卡。强烈建议换成淘宝镜像:

# 一次性设置 npm 镜像(永久生效)
npm config set registry https://registry.npmmirror.com

# 验证是否切换成功
npm config get registry
# 输出: https://registry.npmmirror.com

# 也可以用 nrm 工具快速切换源
npm install -g nrm
nrm use taobao    # 切换到淘宝
nrm use npm       # 切回官方
nrm test          # 测速比较各源

小结

到此你应该已经能在本地跑起来 Node 程序了。记住开发四件套:装 LTS → 用 nvm 管版本 → npm init 建项目 → node xxx.js 跑代码。环境就绪,下一篇我们正式学 Node 的模块系统——这是组织代码、复用逻辑的基础。

← 上一篇 Node.js 简介

下一篇 Node.js 模块系统 →

✈️💬