Node.js安装及命令行运行Js文件完整指南

要在本地计算机上脱离浏览器直接执行 JavaScript 代码，最基础且成熟的解决方案就是配置 Node.js 运行时环境。本文将从官方安装包获取与版本选型开始，逐步讲解操作系统的环境变量配置、终端状态验证，再到实际编写一个 .js 脚本并通过命令行指令正确执行与传参，最后给出高频报错的排查策略，帮助读者建立清晰、可靠的 Node.js 本地开发基石。

一、Node.js 核心版本选型与系统安装

Node.js 是一个基于 Chrome V8 引擎构建的开源 JavaScript 运行环境，它打破了 JavaScript 只能运行在浏览器端沙箱中的限制，使得开发者能够在操作系统的命令行、服务器端以及自动化脚本中直接运行 JS 代码。在正式安装之前，明确版本分支是避免后续兼容性隐患的第一步。

访问 Node.js 官方网站（nodejs.org）时，通常会看到两组不同分支的下载选项：

• LTS（Long Term Support，长期支持版）：推荐绝大多数学习者和生产项目选择。该版本具备长达 30 个月的稳定维护期，核心 API 极具向后兼容性，第三方 npm 依赖包的适配度最高。
• Current（当前最新版）：包含最新的 ECMAScript 语法特性与 Node.js 实验性功能。更新频率高，但部分底层编译依赖或旧版模块可能会出现兼容性波动。

二、环境检测与终端就绪状态验证

安装向导执行“Finish”后，操作系统已将 Node.js 的主执行文件释放到了系统目录中。为了确认命令行解释器能否准确定位该程序，必须进行终端验证。

打开系统自带的命令行终端（Windows 用户按 Win + R 输入 powershell 或 cmd；macOS 用户通过聚焦搜索打开“终端”或 Terminal），输入以下两条查询指令：

# 查看当前已安装的 Node.js 版本
node -v

# 查看内置集成的 npm 包管理器版本
npm -v

标准输出结果示例（版本号随官方发布周期递增）：

v20.18.0
10.8.2

如果输出均呈现以 v 开头的版本号，证明 Node.js 的可执行路径已成功写入操作系统的 PATH 环境变量，底层调用链路畅通。

三、创建第一个 JavaScript 脚本文件

编写与执行脚本前，建议在磁盘上创建一个专用的工作目录，以保持文件系统的条理清晰。例如可以在个人文档目录下建立名为 node-demo 的文件夹。

1. 新建项目目录与文件

在终端中可以通过命令行直接快速创建文件夹并进入：

# 创建工作文件夹
mkdir node-demo

# 进入该目录
cd node-demo

2. 编写脚本代码

使用任一文本编辑器（如 VS Code、Sublime Text 或系统自带记事本）在该目录下新建一个名为 app.js 的文件。输入以下代码，涵盖控制台输出、时间处理与基础逻辑运算：

// app.js - 第一个命令行脚本示例
console.log("====================================");
console.log("欢迎运行 Node.js 命令行脚本程序！");
console.log("====================================");

// 获取系统当前时间与运行环境信息
const currentTime = new Date().toLocaleString();
const nodeVersion = process.version;
const platform = process.platform;

console.log(`执行时间: ${currentTime}`);
console.log(`Node 版本: ${nodeVersion}`);
console.log(`操作系统: ${platform}`);

// 基础函数定义与调用
function calculateTotal(items) {
  return items.reduce((sum, current) => sum + current, 0);
}

const sampleData = [12.5, 45.0, 88.2, 33.1];
const total = calculateTotal(sampleData);
console.log(`样本数据求和结果: ${total.toFixed(2)}`);
console.log("====================================");

四、在命令行中运行 JS 脚本及进阶操作

有了 app.js 之后，在终端中执行它只需要一个极简指令：

node app.js

终端控制台将立即输出以下结果：

====================================
欢迎运行 Node.js 命令行脚本程序！
====================================
执行时间: 2026/10/25 13:30:00
Node 版本: v20.18.0
操作系统: darwin
样本数据求和结果: 178.80
====================================

1. 路径执行原则：相对路径与绝对路径

在命令行运行脚本时，解释器必须知道目标文件的具体磁盘位置：

• 在当前文件所在目录：直接运行 node app.js 或 node ./app.js（./ 代表当前工作目录）。
• 从其他任意目录调用：提供相对路径或完整绝对路径。例如：

  # 相对路径执行上一级或子目录中的文件
  node ./subfolder/worker.js
  
  # Windows 绝对路径
  node "C:\Users\username\node-demo\app.js"
  
  # macOS / Linux 绝对路径
  node "/Users/username/node-demo/app.js"

2. 传递并接收命令行参数（process.argv）

命令行工具的一大优势是可以随时传入不同的动态参数。Node.js 提供了全局对象 process.argv，它是一个存储着所有启动参数的数组。

新建一个名为 greet.js 的脚本，内容如下：

// greet.js
// process.argv 的前两个固定元素分别为 node 路径和当前脚本路径
// 从索引 2 开始才是用户输入的自定义实参
const args = process.argv.slice(2);

console.log("接收到的参数数组:", args);

if (args.length === 0) {
  console.log("提示：请提供姓名参数，例如: node greet.js 张三");
} else {
  const userName = args[0];
  const role = args[1] || "普通访客";
  console.log(`你好，${userName}！你的登录角色为：[${role}]。`);
}

在命令行中传入参数并执行：

node greet.js 李明 工程师

预期回显：

接收到的参数数组: [ '李明', '工程师' ]
你好，李明！你的登录角色为：[工程师]。

五、高频运行报错与故障排查决策矩阵

初学者在命令行执行 JavaScript 文件时，常常因为路径定位偏差、模块标准混淆或权限配置不当而遭遇异常。以下梳理了四大最常见错误场景及其确切解决路径：

报错提示关键词	典型发生诱因	定位与修正方案
'node' 不是内部或外部命令 / command not found: node	安装时漏勾选 PATH 环境变量，或安装后未关闭重启既有终端窗口。	重启终端；若仍未恢复，手动将 Node 安装路径（如 C:\Program Files\nodejs\）追加至系统环境变量 Path 中。
Error: Cannot find module '.../app.js'	当前终端的工作路径与文件实际所在磁盘目录不一致，或文件名拼写错误。	先执行 pwd（macOS/Linux）或 cd（Windows）核对当前路径，使用 cd 切换到正确目录，或提供完整绝对路径。
Cannot use import statement outside a module	在默认 CommonJS 环境中直接使用了 ES Module 的 import / export 语法。	将文件扩展名改为 .mjs，或在项目根目录新建 package.json 并声明 "type": "module"。
SyntaxError: Unexpected identifier / token	代码中存在未闭合的括号、引号，或使用了当前 Node 版本尚未支持的前沿语法。	检查报错定位的代码行号与上下文标点闭合情况；确认本地 Node 版本是否过旧（node -v）。

六、全文总结与后续进阶建议

掌握 Node.js 的安装与命令行运行是现代 JavaScript 开发的基石。梳理整个操作流程，读者只需要牢记以下几个关键核心点：

1. 安装规范：下载官网 LTS 长期支持版，安装向导中确认勾选 Add to PATH，安装完毕后务必重启终端以重新加载全局环境变量。
2. 就绪验证：在任何目录下均可执行 node -v 与 npm -v，能返回版本语义号即代表底层调用通路正常。
3. 脚本执行：使用纯文本编辑器编写保存 .js 文件，在终端中切换到对应工作目录后，键入 node <文件名.js> 即可即时运行。
4. 参数交互：通过 process.argv.slice(2) 可以优雅地接收来自命令行的动态用户参数，实现自动化脚本的输入输出。

完成本文的基础操作后，读者可以进一步了解 npm 包管理器的依赖安装、package.json 项目元数据管理，以及使用 nodemon 等守护工具实现代码保存自动热重载，逐步构建出更加高效、专业的本地开发工作流。