本地电脑怎么安装Node.js并运行JavaScript脚本

一、准备工作与版本选择：LTS 与 Current 的差异

JavaScript 最初是专门设计在浏览器内运行的客户端脚本语言。如果脱离浏览器（例如在本地操作系统的终端、服务器或后台环境）直接运行 JavaScript，计算机底层的操作系统并不能直接理解它。Node.js 充当了桥梁角色：它封装了 Google Chrome 浏览器的 V8 JavaScript 引擎，并提供了文件操作、网络通信、进程控制等底层系统 API，让 JavaScript 能够像 Python、Go 一样作为通用的本地服务端与系统脚本语言运行。

进入 Node.js 官方网站（https://nodejs.org）时，首页通常会并排呈现两个不同的下载版本。理解这两个版本的定位差异，是避免后续环境不稳定或依赖报错的关键第一步：

对于初次接触或以日常实用脚本为主的读者，强烈建议点击下载 LTS（Long Term Support） 版本。LTS 保证了更平稳的语法支持与依赖包生态兼容，能最大程度避免因底层版本变动引发的晦涩报错。

二、各系统下的具体安装操作步骤

Node.js 官方为主流平台提供了标准图形化安装向导，安装逻辑清晰直观。

1. Windows 操作系统安装步骤

1. 下载以 .msi 结尾的 Windows 安装程序（官网通常会自动识别 64-bit 架构）。
2. 双击打开安装包，点击“Next”进入许可协议，勾选“I accept the terms in the License Agreement”。
3. 在“Destination Folder”界面指定安装路径（默认通常为 C:\Program Files\nodejs\，直接保持默认即可）。
4. 进入“Custom Setup”自定义设置页。在这里，务必确保 “Add to PATH” 选项处于启用状态（默认即为启用）。这一步是让系统命令行能够全局调用 node 指令的关键。
5. 后续界面中会询问是否安装“Tools for Native Modules”（编译原生 C/C++ 依赖所需的 Python 与 Visual Studio 构建工具）。若平时仅编写与运行常规 JavaScript 脚本，保持不勾选以节省硬盘空间与下载时间；点击“Next”并点击“Install”，等待进度条结束点击“Finish”。

2. macOS 操作系统安装步骤

1. 下载对应芯片架构的 .pkg 安装包（macOS 提供了针对 Apple Silicon（M系列芯片）及 Intel 芯片的独立或统一包，官网会自动推测）。
2. 双击 .pkg 文件启动 macOS 标准安装器，按照提示依次点击“继续”。
3. 阅读软件许可并同意协议，安装位置保持默认的 Macintosh HD。
4. 输入当前电脑用户的管理员开机密码允许写入，安装程序会自动把可执行二进制文件部署至 /usr/local/bin 或 /opt/homebrew/bin 并完成环境变量挂载。
5. 提示“安装成功”后，点击关闭并移至废纸篓即可。

三、验证安装：确认环境与路径生效

安装完成后，需要通过系统命令行终端核对 Node.js 及其自带的 npm（Node Package Manager）是否安装成功。

在 Windows 上，按下键盘快捷键 Win + R，在运行框中输入 cmd 或 powershell 并回车；在 macOS 上，按下 Command + 空格 唤出聚焦搜索，输入 终端 或 Terminal 并打开。

node -v
npm -v

v20.18.0
10.8.2

如果终端能够准确打印出以小写字母 v 开头的版本数字（具体主次版本号取决于安装时官方最新的 LTS 版本），则说明 Node.js 的核心引擎已在当前电脑上配置妥当。

四、在本地运行 JavaScript 的两种核心模式

安装完成后，可以通过两种不同途径运行 JavaScript 代码：交互式终端（REPL 模式）与执行脚本文件模式（Script File 模式）。两者的工作流程与适用场景各有侧重：

方式 A：使用 REPL 交互模式快速求值

在终端中只敲入 node 并按回车，不带任何参数，即可进入 Node.js 提供的 REPL（Read-Eval-Print Loop）环境。此时终端前缀提示符会变成 >。

node
> console.log("Hello Node.js");
Hello Node.js
undefined
> [1, 2, 3].map(n => n * 2);
[ 2, 4, 6 ]

每按一次回车，引擎就会立刻解析当前语句并输出运算结果。如需退出 REPL 环境返回普通命令行，可以连续按两次 Ctrl + C，或者直接输入 .exit 并回车。

方式 B：编写 .js 脚本文件并用 Node 运行（常规做法）

实际开发与任务处理中，所有代码都会保存在文本文件中，以便复用与管理。具体分为创建文件、定位路径、发起运行三个步骤。

五、实战演练：创建并运行一个完整的 JavaScript 脚本

下面我们通过一个具备实际功能的完整脚本示例，演示从建立文件夹到得到输出的规范全过程。

步骤 1：新建项目目录与脚本文件

在本地磁盘（例如桌面）创建一个空目录 node-demo，并在该文件夹内新建一个文本文件，命名为 app.js。

步骤 2：在脚本文件中写入代码

使用任意纯文本编辑器（如 VS Code、Sublime Text，甚至系统自带的记事本），将以下 JavaScript 代码粘贴进 app.js 并保存：

// 引入 Node.js 内置的系统信息与时间模块
const os = require("os");

function getSystemOverview() {
  const hostname = os.hostname();
  const platform = os.platform();
  const totalMemGB = (os.totalmem() / 1024 / 1024 / 1024).toFixed(2);
  const freeMemGB = (os.freemem() / 1024 / 1024 / 1024).toFixed(2);

  return {
    hostname,
    platform,
    totalMemGB: `${totalMemGB} GB`,
    freeMemGB: `${freeMemGB} GB`
  };
}

console.log("=== JavaScript 脚本正在执行 ===");
console.log("当前运行时间:", new Date().toLocaleString());
console.log("系统环境概况:", getSystemOverview());
console.log("=== 脚本执行结束 ===");

步骤 3：在终端中切换路径并执行脚本

打开终端，使用 cd（Change Directory）命令进入 app.js 存放的目录。假设文件放在桌面的 node-demo 文件夹：

# Windows 示例（将 用户名 替换为你的实际 Windows 用户名）
cd C:\Users\用户名\Desktop\node-demo
node app.js

# macOS 示例
cd ~/Desktop/node-demo
node app.js

=== JavaScript 脚本正在执行 ===
当前运行时间: 2026/10/24 17:30:15
系统环境概况: {
  hostname: 'MacBook-Pro.local',
  platform: 'darwin',
  totalMemGB: '16.00 GB',
  freeMemGB: '5.24 GB'
}
=== 脚本执行结束 ===

六、常见问题排查与解决要点

在初次安装与执行脚本过程中，由于操作习惯与系统配置差异，可能会遇到一些典型报错。参照以下图示逻辑可迅速定位症结：

1. 报错：Cannot find module（找不到指定模块或文件）

这是新手遇到频率最高的问题。Node.js 执行 node 文件名.js 时，默认会在当前终端所在的“工作目录”寻找该文件。如果你的 app.js 放在桌面，而终端启动时处于系统用户根目录，就会因找不到路径而抛出错误。

解决方法：

• 在执行命令前，先在终端中输入 dir（Windows）或 ls（macOS/Linux），查看当前目录下是否存在你刚才编写的 .js 文件。
• Windows 系统支持更便捷的技巧：在文件资源管理器中直接打开放有脚本的文件夹，在顶部地址栏直接输入 cmd 并敲回车，系统就会自动打开一个定位在该目录下的终端窗口。
• 防范文件隐藏扩展名陷阱：Windows 默认隐藏常见文件扩展名，部分用户新建文本文档重命名为 app.js 后，实际真实全名为 app.js.txt。确保系统文件查看设置中勾选了“显示文件扩展名”。

2. PowerShell 脚本执行策略拦截问题

在 Windows 10/11 上使用 PowerShell 运行后续某些由 npm 安装的脚本工具时，可能触发 PSSecurityException，提示“在此系统上禁止运行脚本”。这是 Windows 系统出于防御机制默认开启了 Restricted 策略。

解决方法：右键点击开始菜单选择“终端管理员”打开 PowerShell，输入 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 并回车确认即可，这一配置仅放行本地自己编写的脚本和经受信认证的远程脚本。

七、总结

安装 Node.js 实质上就是为电脑补充一个具备完整底层系统交互能力的 JavaScript 解释器。掌握下载官方 LTS 安装包、验证 node -v 环境变量挂载、编写标准 .js 文件并通过 node [文件名] 执行的闭环链路后，本地计算机便具备了独立运行 JavaScript 任务的全部能力。后续无论是进行自动化批处理、学习前端现代化工程构建工具，还是编写本地后端服务端程序，都建立在这一稳定环境之上。