1. 引言Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境它让开发者可以使用 JavaScript 编写服务端代码。无论是搭建 Web 服务器、构建命令行工具还是作为前端工程化的基础如 Webpack、Vite 等Node.js 都是现代开发中不可或缺的一环。本教程将带你从零开始完成 Node.js 的下载、安装、环境配置以及验证帮助你快速搭建可用的开发环境。2. 准备工作在开始安装之前建议先确认以下几点操作系统本教程覆盖 Windows、macOS 和 Linux 三大主流平台。网络环境安装过程中需要从官网或镜像源下载安装包请确保网络畅通。权限Windows 下安装通常需要管理员权限macOS/Linux 下建议使用普通用户配合sudo执行特权命令。3. 下载 Node.js网盘下载百度网盘下载https://pan.baidu.com/s/1PTlW_PZomsBt0E6vR13ZIg?pwdwu17夸克网盘下载https://pan.quark.cn/s/4d24d0f58bdf?pwdXeZ83.1 官方下载地址访问 Node.js 官网https://nodejs.org官网首页会提供两个版本LTS长期支持版稳定性优先适合生产环境和大多数开发者推荐下载。Current当前最新版包含最新特性但可能不够稳定适合尝鲜或需要新 API 的场景。3.2 各平台安装包说明平台安装包格式说明Windows.msi或.zip.msi为图形化安装向导.zip为免安装绿色版macOS.pkg或.tar.gz.pkg为图形化安装包.tar.gz为源码压缩包Linux.tar.xz或通过包管理器推荐使用系统包管理器安装便于后续升级4. 安装 Node.js4.1 Windows 安装双击下载的.msi安装包点击Next进入下一步。勾选I accept the terms in the License Agreement点击Next。选择安装路径默认即可点击Next。在Custom Setup页面确保Add to PATH选项被选中这样安装完成后可以直接在命令行中使用node命令。点击Install开始安装等待完成即可。4.2 macOS 安装双击下载的.pkg安装包点击继续。阅读许可协议并同意点击安装。输入用户密码授权安装等待完成即可。提示macOS 用户也可以使用 Homebrew 安装命令为brew install node这种方式更便于后续升级。4.3 Linux 安装以 Ubuntu/Debian 为例使用包管理器安装sudoaptupdatesudoaptinstallnodejsnpm注意系统源中的 Node.js 版本可能较旧。如需安装特定版本推荐使用 nvmNode Version Manager进行管理下文会详细介绍。5. 验证安装安装完成后打开终端Windows 为 CMD 或 PowerShell输入以下命令验证node-v如果输出类似v20.11.0的版本号说明 Node.js 安装成功。再验证 npmNode 包管理器npm-v输出类似10.2.4的版本号即表示 npm 正常。6. 配置 npm 镜像源由于默认的 npm 源位于国外国内开发者下载依赖时可能较慢。推荐将 npm 源切换为淘宝镜像npmconfigsetregistry https://registry.npmmirror.com验证是否生效npmconfig get registry输出https://registry.npmmirror.com即表示配置成功。7. 使用 nvm 管理多版本推荐当需要同时维护多个 Node.js 版本时推荐使用 nvm。7.1 安装 nvmWindows前往 nvm-windows 下载安装包安装后以管理员身份运行 CMD。macOS/Linux执行以下命令curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh|bash安装完成后重新打开终端使配置生效。7.2 常用 nvm 命令# 查看已安装版本nvm list# 安装指定版本nvminstall20.11.0# 切换版本nvm use20.11.0# 设置默认版本nvmaliasdefault20.11.08. 编写第一个 Node.js 程序创建一个hello.js文件写入以下内容console.log(Hello, Node.js!);在终端中执行nodehello.js输出Hello, Node.js!即表示运行成功。9. 常见问题排查9.1node不是内部或外部命令原因安装时未勾选Add to PATH或 PATH 环境变量未生效。解决手动将 Node.js 安装目录添加到系统 PATH 中并重新打开终端。9.2 npm 安装依赖速度慢原因默认源在国外。解决按第 6 节配置镜像源或使用cnpm工具。9.3 权限不足EACCES原因全局安装依赖时没有写权限。解决macOS/Linux 下使用sudo执行或通过 nvm 安装 Node.js 以规避权限问题。10. 总结本文从下载、安装、验证到环境配置完整介绍了 Node.js 的搭建流程。核心要点如下优先选择LTS 版本稳定性更有保障。安装时确保Add to PATH被勾选。国内开发者建议切换 npm 镜像源提升下载速度。多版本需求场景下使用nvm进行版本管理。至此你的 Node.js 开发环境已经就绪可以开始愉快的编码之旅了。