Node.js：在任何地方运行 JavaScript #

Node.js 是什么？ #

Node.js 是一个免费、开源、跨平台的 JavaScript 运行时环境，它让开发人员能够创建服务器、Web 应用、命令行工具和脚本。

在 Node.js 出现之前，JavaScript 几乎只能在浏览器里运行，前端与服务端之间存在天然的语言鸿沟。Node.js 把 V8 引擎带到了浏览器之外，使 JavaScript 可以直接在操作系统上执行文件读写、网络通信、进程管理等工作，从而让开发者用同一门语言完成前后端开发，大幅降低技术栈切换成本。它特别适合构建高并发的网络服务、API 接口、实时应用、自动化脚本和各类命令行工具，是目前 Web 后端与全栈开发领域使用最广泛的运行时之一。项目由 OpenJS Foundation 治理，官方同时提供 LTS（长期支持）与 Current（最新特性）两条发布线。

Node.js 有哪些亮点特色？ #

• 事件驱动与非阻塞 I/O：Node.js 采用事件驱动、非阻塞 I/O 模型，非常适合处理大量并发连接，在 I/O 密集型场景（如 API 服务、实时通信、代理转发）中表现出色，无需为每个请求占用独立线程。
• 一门语言贯通前后端：前端开发者可以直接复用 JavaScript 技能编写服务端代码、命令行工具和构建脚本，显著减少学习成本与团队协作成本。
• 内置能力丰富的核心模块：官方标准库开箱即用，涵盖 HTTP 服务（node:http）、文件系统（node:fs）、加密哈希（node:crypto）、流式管道（node:stream）、多线程（node:worker_threads）以及内置测试框架（node:test），无需引入第三方依赖即可完成常见开发任务。
• npm 包生态：随 Node.js 一同分发的 npm 是全球规模最大的软件包注册表之一，开发者可以借助海量开源模块快速搭建项目，并通过 package.json 精确管理依赖版本。
• 跨平台一致体验：同一份代码可在 Windows、macOS 与 Linux 上运行，官方为各平台提供对应的安装程序与独立二进制文件，方便在本地开发、CI/CD 与生产服务器之间保持一致。
• LTS 与 Current 双轨发布：官方为追求稳定性的生产环境提供长期支持版本（当前 v24.21.0 为 Latest LTS），同时为希望尝鲜新特性的开发者提供 Current 版本（v26.10.0 为 Latest Release），用户可按需选择。
• 完全免费且开源：Node.js 采用开源许可发布，由 OpenJS Foundation 治理，任何人可自由使用、修改和分发，商业项目使用同样无需支付授权费用。
• 活跃的全球社区与完善文档：官方提供多语言文档、学习资料、博客与版本变更日志，并有大量合作伙伴与社区贡献者持续维护基础设施与生态。

免费下载 Node.js #

以下为官方提供的各平台安装包，点击链接即可下载。

提示：以上安装包对应 v24.21.0 LTS 版本，安装时会一并安装 npm。若需要最新特性版本或其他平台（如 Linux 独立二进制、源码压缩包），可前往官网下载页面获取。官网同时提供已签名的 SHASUMS 校验文件，可用于验证下载包的完整性。

Node.js 如何使用？ #

Node.js 本身没有图形界面，主要通过命令行使用。下面是新手最常见的基础流程：

1. 验证安装是否成功：安装完成后打开终端（Windows 可使用 CMD 或 PowerShell，macOS/Linux 使用 Terminal），输入 node -v 与 npm -v，若分别输出 v24.21.0 和对应的 npm 版本号，说明安装成功。

2. 运行一个 JavaScript 文件：新建文件 hello.js，写入 console.log('Hello Node.js')，然后在终端执行 node hello.js，即可看到输出结果。

3. 启动一个 HTTP 服务器：新建 server.mjs，使用官方示例代码创建服务：

   import { createServer } from 'node:http';
   
   const server = createServer((req, res) => {
     res.writeHead(200, { 'Content-Type': 'text/plain' });
     res.end('Hello World!\n');
   });
   
   server.listen(3000, '127.0.0.1', () => {
     console.log('Listening on 127.0.0.1:3000');
   });
   

   执行 node server.mjs，然后在浏览器访问 http://127.0.0.1:3000，即可看到 “Hello World!”。

4. 初始化项目并安装依赖：在项目目录中执行 npm init -y 生成 package.json，再执行 npm install <包名> 安装所需的三方模块，例如 npm install express。

5. 按需使用内置模块：官方文档中的示例覆盖了常见任务，例如用 node:test 编写单元测试、用 node:crypto 计算文件哈希、用 node:stream 完成压缩管道、用 node:worker_threads 开启多线程处理计算密集型任务。

想系统学习，可以访问官网「学习」板块中的学习资料，以及「文档」板块查阅完整的 API 说明。

Node.js 的常见问题？ #

Node.js 和浏览器里的 JavaScript 有什么区别？ 两者语法基础相同，但运行环境不同。浏览器中的 JavaScript 受限于沙箱，主要用于操作页面；Node.js 则可以直接访问文件系统、网络、进程等操作系统能力，因此更适合编写服务端程序、脚本和命令行工具。

LTS 版本和 Current 版本应该选哪个？ LTS（长期支持）版本经过更充分的验证，适合生产环境和大多数用户，当前为 v24.21.0；Current 版本包含最新特性，当前为 v26.10.0，适合希望尽早体验新功能或在测试环境试用的开发者。官网在下载页也提示：想更快用上新特性，可改用最新版本。

Node.js 是免费的吗？可以用于商业项目吗？ 是的。Node.js 是免费、开源、跨平台的运行时环境，由 OpenJS Foundation 治理，个人与商业项目均可自由使用，无需购买授权。

需要单独安装 npm 吗？ 不需要。官方提供的安装程序会随 Node.js 一并安装 npm，安装完成后即可在终端直接使用 npm 命令。

安装后提示 “node 不是内部或外部命令” 怎么办？ 通常是环境变量未生效。可以先关闭并重新打开终端；若仍无效，请检查安装时是否勾选了添加到 PATH 的选项，或将 Node.js 安装目录手动加入系统环境变量。

同一个项目可以同时使用多个 Node.js 版本吗？ 可以。开发中常用版本管理工具（如 nvm）在同一台机器上安装并切换多个版本，方便在不同项目间隔离运行时环境。（该做法为社区通用实践，官网下载页亦提供所有历史版本供下载。）

Node.js 如何安装？ #

Node.js 官方为各平台提供安装程序与独立二进制文件，以下为常见安装方式：

Windows #

1. 根据 CPU 架构选择安装包：多数电脑为 x64，ARM 设备（如部分 Surface、骁龙笔记本）选择 arm64。
2. 双击 .msi 文件启动安装向导，接受许可协议。
3. 按需勾选组件与「添加到 PATH」选项（建议保持默认）。
4. 点击安装并等待完成，随后在终端执行 node -v 验证。

如需静默安装，可在命令行中执行 msiexec /i node-v24.21.0-x64.msi /qn（需管理员权限）。

macOS #

1. 下载 node-v24.21.0.pkg 安装包。
2. 双击运行，按提示完成安装向导。
3. 打开「终端」，执行 node -v 与 npm -v 确认版本。

Linux #

1. 推荐使用版本管理工具 nvm 安装与切换版本，便于管理多个项目环境。
2. 也可以使用系统包管理器安装，例如 Debian/Ubuntu 下的 sudo apt install nodejs，或通过官方提供的独立二进制压缩包解压后配置 PATH。
3. 安装完成后执行 node -v 验证。

官网说明：Node.js 项目不维护某些第三方包管理器及其安装脚本，如遇问题请查阅对应工具的官方站点。官网下载页同时提供安装程序（.gz）、独立二进制（.gz）以及已签名的源码压缩包，可按需选择。

Node.js 如何卸载？ #

Windows #

1. 打开「设置 → 应用 → 已安装的应用」（或控制面板中的「程序和功能」）。
2. 找到 Node.js，点击「卸载」并按照向导完成操作。
3. 手动检查并清理残留目录，例如 C:\Program Files\nodejs、%AppData%\npm、%AppData%\npm-cache 以及用户目录下的 .npmrc。

macOS #

1. 若通过 .pkg 安装，可执行官方文档提供的删除命令清理二进制与模块目录（涉及 /usr/local/bin/node、/usr/local/lib/node_modules/npm 等路径）。
2. 若通过 nvm 安装，直接执行 nvm uninstall <版本号> 即可移除指定版本。
3. 如需彻底清理，可一并删除用户目录下的 .npm、.npmrc 等缓存与配置文件。

Linux #

1. 若使用系统包管理器安装，执行 sudo apt remove nodejs（Debian/Ubuntu）或对应的移除命令。
2. 若使用 nvm 安装，执行 nvm uninstall <版本号>。
3. 检查并清理 /usr/local/lib/node_modules、~/.npm、~/.npmrc 等残留内容。

提醒：卸载后若仍需运行原有的 npm 全局工具或依赖 Node.js 的项目，请先将相关依赖迁移到其他运行环境。部分全局安装的包与缓存不会随卸载自动删除，需要手动清理以释放磁盘空间。