Node.js 介绍和安装

Node.js 是让 JavaScript 运行在浏览器之外的运行时。现代前端项目里的 Vite、VitePress、Next.js、Vue、React、Tailwind、ESLint、Prettier 等工具，通常都依赖 Node.js 和它自带的包管理器 npm。

对 VibeCode 项目来说，Node.js 主要承担三件事：

• 启动本地开发服务，例如 npm run docs:dev。
• 安装和管理项目依赖，例如 npm install。
• 构建静态产物，例如 npm run docs:build。

版本选择

优先选择 LTS 版本。LTS 是长期支持版本，适合团队项目和生产构建。Node.js 官网会在下载页标出当前 LTS 和 Current 版本。

本项目建议先检查：

node -v
npm -v

如果团队没有特殊要求，使用当前 LTS 主版本即可。多个项目需要不同 Node.js 版本时，优先使用 nvm 管理。

Windows 安装

方式一：官网下载 MSI 安装包。

1. 打开 Node.js 下载页。
2. 选择 LTS 版本。
3. 下载 Windows Installer。
4. 安装时保持默认选项，确保 npm 一起安装。
5. 重新打开 PowerShell，执行：

node -v
npm -v

方式二：如果你经常切换项目版本，使用 nvm-windows。详见 nvm 介绍和安装。

macOS / Linux 安装

推荐使用 nvm：

nvm install --lts
nvm use --lts
node -v
npm -v

也可以使用系统包管理器，但团队项目更推荐版本管理器，避免系统级 Node.js 被多个项目相互影响。

项目内验证

进入项目根目录：

npm install
npm run docs:dev
npm run docs:build

如果 npm install 失败，优先检查 Node.js 主版本是否符合项目要求，再删除 node_modules 后重新安装。

常见问题

问题	处理方式
node 不是内部或外部命令	重新打开终端；检查 PATH；Windows 重新安装 Node.js
npm 不是内部或外部命令	Node.js 安装不完整，重新安装 LTS
项目 A 能跑，项目 B 跑不了	使用 nvm 切换到项目要求的 Node.js 版本
构建结果和别人不同	固定 Node.js 版本，并提交 lock 文件

来源

• Node.js 下载页
• Node.js Releases