JavaScript运行环境怎么下载？Node.js安装与配置教程

作者：星河时间：2026-10-30 18:25:23浏览：447

本文详细介绍如何下载并安装独立的JavaScript运行环境Node.js，包括LTS稳定版选择、Windows与macOS安装步骤、环境验证、环境变量配置及常见问题排查。

在默认情况下，JavaScript 只能在浏览器控制台或嵌入网页中运行。如果想要在自己的电脑上直接运行 JavaScript 脚本、构建本地工具、开发 Web 服务端或者使用前端脚手架，就需要一套脱离浏览器的独立执行环境。这个被业界广泛使用的独立运行环境就是 Node.js。下载并安装 Node.js，就是在本地计算机上建立 JavaScript 运行环境的标准方案。

一、认识 JavaScript 运行环境：为什么是 Node.js？

JavaScript 本身是一门编程语言规范，必须依赖宿主环境提供的执行引擎与接口支持才能工作。在浏览器中，JavaScript 依托于浏览器的引擎（如 Chrome 的 V8）和 Web API（如 DOM、BOM、Fetch），因而主要处理网页交互，受到严格沙箱限制，无法自由读写本地磁盘文件或监听网络端口。

Node.js 则是将 Chrome V8 引擎抽离出来，配合异步 I/O 驱动库 libuv 以及 C/C++ 底层绑定，封装成了独立的跨平台运行时。在 Node.js 中，开发者可以使用操作系统原生能力，包括读写文件系统、建立网络 Socket 连接、创建子进程等。因此，当我们谈论“下载 JavaScript 运行环境”时，实际上指的就是获取并安装 Node.js 安装包。

图 1：浏览器环境与 Node.js 独立运行环境架构及能力差异

二、选择与下载官方安装包

下载 Node.js 最安全且规范的途径是访问其官方网站（https://nodejs.org）。进入官网首页后，通常会看到两个版本分支可供下载：LTS（长期支持版） 和 Current（最新尝鲜版）。

LTS（Long Term Support）版：稳定性最高，官方会提供长期的安全修复和维护周期（通常为 30 个月），主流类库和框架均优先保障与 LTS 版本的兼容性。学习开发、生产部署建议直接选择此版本。
Current 版：包含 Node.js 社区最新合入的语法特性和实验性功能，更新频率高，但部分第三方依赖库可能尚未适配。仅适合需要测试最新语言规范的场景。

图 2：Node.js LTS 与 Current 版本的定位与选型考量

三、安装全流程与关键选项

无论是 Windows 还是 macOS，Node.js 都提供了向导式安装包，双击即可根据提示完成部署。整个安装与验证可以拆解为四个连续步骤：

图 3：Node.js 安装、配置与验证核心链路

1. Windows 环境安装细则

双击运行下载的 .msi 文件，进入安装向导并点击“Next”。
在“End-User License Agreement”页面勾选同意条款后继续。
选择安装路径：默认通常为 C:\Program Files\nodejs\，可以修改盘符，但不建议路径中包含中文或空格字符。
Custom Setup（定制安装）：在此步骤中，请确保“Add to PATH”处于默认激活状态（标有本地硬盘图标）。这会自动将 Node.js 的执行目录注入系统 PATH 环境变量。
Tools for Native Modules（可选提示）：向导可能会询问是否自动安装 Python 与 Visual Studio 构建工具（用于编译含有 C++ 原生扩展的 npm 包）。初学者若暂不开发底层 C++ 插件，可不勾选，避免下载数个 G 的编译套件；后续有需要时可单独配置。
点击“Install”，等待进度条走完后点击“Finish”。

2. macOS 环境安装细则

双击运行 .pkg 文件，按照提示点击“继续”。
安装程序会自动将二进制文件释放到 /usr/local/bin（Intel 芯片）或 /opt/homebrew/bin 等系统可执行路径中，并自动处理环境映射。
输入系统管理员密码以授权写入，提示“安装成功”后关闭安装器。

四、验证运行环境与执行首个脚本

安装完成后，必须打开系统的命令行终端来验证安装是否生效：

Windows 用户：按 Win + R 键，输入 cmd 或 powershell 并回车。
macOS 用户：打开“终端”（Terminal）或 iTerm。

注意：如果终端在安装 Node.js 之前就已经打开，请先将其完全关闭后再重新启动，否则终端无法加载刚更新的环境变量。

在终端中依次输入以下两条命令查询版本：

node -v
npm -v

如果正常输出版本号（示例）：

v20.18.0
10.8.2

这说明 Node.js（JavaScript 解释器）以及随附的 npm（包管理器）均已在本地操作系统中成功注册。

执行你的第一个 JavaScript 脚本

确认环境就绪后，我们可以在本地电脑的任意文件夹中创建一个测试文件 test.js，内容如下：

// test.js
const os = require('os');

console.log("JavaScript 运行环境已就绪！");
console.log("当前操作系统平台：", os.platform());
console.log("CPU 架构：", os.arch());

随后在终端进入该文件所在目录，使用 node 命令执行它：

node test.js

终端将直接打印系统信息，这印证了 JavaScript 代码已经直接在你的电脑上由 Node.js 解释并运行，无须依赖任何网页浏览器。

五、重要配置：全局包路径与镜像加速

在长期使用中，我们经常使用 npm 全局安装工具（如 npm install -g pnpm 或各类脚手架）。为了避免默认安装在系统 C 盘占用空间或由于权限不足产生 EACCES 报错，建议调整 npm 全局模块和缓存的存储路径。

1. 自定义 npm 全局路径（以 Windows 为例）

在打算存放全局模块的目录（例如 D:\nodejs_global）下新建两个子文件夹：node_global 和 node_cache，然后在终端执行命令绑定：

npm config set prefix "D:\nodejs_global\node_global"
npm config set cache "D:\nodejs_global\node_cache"

设置完成后，需要将 D:\nodejs_global\node_global 添加到操作系统的“系统变量”或“用户变量”中的 Path 项内，这样全局安装的命令行工具才能在任意目录下直接被调用。

2. 配置国内 npm 镜像源

默认情况下，npm 会从官方海外镜像源拉取依赖包，受网络波动影响可能下载缓慢。国内开发者可以将其配置为国内高速镜像：

# 查看当前镜像源
npm config get registry

# 设置为腾讯云或淘宝镜像源（以官方镜像镜像源镜像代理为例）
npm config set registry https://registry.npmmirror.com

# 再次查看确认
npm config get registry

图 4：本地 JavaScript 运行环境配置完整度核验 Checklist

六、常见问题排查与解决办法

现象 / 报错信息	产生原因	针对性解决办法
`'node' 不是内部或外部命令` 或 `command not found: node`	系统的 PATH 环境变量中缺少 Node.js 的可执行文件安装路径，或者安装后未重启终端。	先完全关闭终端并重新开启。若依然报错，手动在“系统属性 - 环境变量 - Path”中追加 Node.js 安装路径（如 `C:\Program Files\nodejs\`）。
安装某些包时提示 `EACCES: permission denied` (macOS/Linux)	npm 尝试向系统根保护目录（如 `/usr/local/lib/node_modules`）写入文件，但当前终端缺少管理员权限。	避免直接使用 `sudo npm install`；应按本文“第五节”修改 npm 全局目录到用户主目录下（如 `~/.npm-global`），并将该路径加入 `~/.zshrc` 或 `~/.bash_profile`。
`npm install` 停滞在 `sill idealTree buildDeps` 无响应	默认官方源网络连接延迟过高或被阻断。	使用 `npm config set registry https://registry.npmmirror.com` 切换国内镜像，或检查系统代理设置。
全局安装的命令行工具提示找不到命令	配置了新的 `prefix` 路径后，未将对应的 `node_global` 路径追加至 PATH 变量中。	找到自定义的 `prefix` 目录，将其完整路径加入系统的 PATH 环境变量中，并重启终端。