如何在命令行中执行JS脚本？

煙雲

发布时间：2025-08-30 15:58:01

554人浏览过

来源于php中文网

原创

要执行JavaScript脚本，需安装Node.js环境，使用node命令运行文件，如node script.js，通过process.argv获取命令行参数，结合模块系统、错误处理和异步控制实现进阶功能。

如何在命令行中执行js脚本？

要在命令行中执行JavaScript脚本，最直接也最普遍的方法就是利用Node.js运行时环境。简单来说，你只需要安装Node.js，然后用

node

命令加上你的脚本文件路径，比如

node your_script.js

就可以了。这让JavaScript从浏览器中解放出来，能在服务器端、开发工具等各种场景下大显身手。

说起在命令行里跑JS，我个人觉得，Node.js简直是改变游戏规则的存在。以前总觉得JavaScript就是浏览器里的专属，但Node.js的出现，彻底把它变成了一个通用的脚本语言。

要开始，你得先确保系统里有Node.js。如果你还没装，去Node.js官网下载对应你操作系统的安装包，或者用包管理器（比如macOS上的Homebrew，

brew install node

；Linux上的

sudo apt install nodejs

和

sudo apt install npm

）安装，这是最稳妥的办法。装好之后，在终端输入

node -v

，能看到版本号就说明一切就绪了。

现在，假设你有一个名为

hello.js

的文件，内容非常简单：

// hello.js
console.log("Hello from the command line!");

你只需要打开终端，导航到

hello.js

所在的目录，然后敲下这个命令：

node hello.js

回车后，你就会看到

Hello from the command line!

这行字。是不是很简单？对我来说，第一次成功的时候，感觉就像打开了新世界的大门。

除了直接运行文件，Node.js还能让你直接在命令行里输入JS代码进行交互式操作，就像一个JS的REPL（Read-Eval-Print Loop）。直接输入

node

命令，不带任何文件，你就能进入这个交互模式。这对于快速测试一些JS片段，或者调试一些小功能，简直是神来之笔。

$ node
> console.log('Hello REPL');
Hello REPL
undefined
> 1 + 1
2
> .exit

输入

.exit

可以退出REPL模式。

命令行运行JavaScript需要什么环境？

其实，我们刚才已经提到了，要在命令行里跑JavaScript，核心就是Node.js。它提供了一个V8 JavaScript引擎的封装，让JS代码脱离浏览器也能运行。这就像是给JavaScript在操作系统层面安了个家。

具体来说，你需要：

Node.js运行时环境： 这是基石。它包含了V8引擎，负责解析和执行你的JavaScript代码。没有它，操作系统就不知道怎么“读懂”你的
```
.js
```
文件。我记得刚开始学的时候，总是混淆Node.js和JavaScript本身，后来才明白Node.js是那个“执行器”。
- 安装方式：
  - 官方网站：
```
nodejs.org
```
    下载安装包，傻瓜式安装。
  - 包管理器：
    - macOS (Homebrew):
```
brew install node
```
    - Linux (apt):
```
sudo apt update && sudo apt install nodejs npm
```
      (注意，有些Linux发行版
```
nodejs
```
      包名可能和Node.js本身有冲突，所以
```
npm
```
      也会单独安装，确保两者都有。)
    - Windows (Chocolatey):
```
choco install nodejs
```
- 验证安装：
  - ```
  node -v
```
  ：检查Node.js版本。
- ```
npm -v
```
    ：检查npm（Node.js包管理器）版本。npm通常会随Node.js一起安装，它是管理项目依赖的利器。
一个文本编辑器： 用来编写你的JavaScript代码。VS Code、Sublime Text、Atom，甚至记事本都行，只要能保存为
```
.js
```
文件就行。

AI小聚
一站式多功能AIGC创作平台，支持AI绘画、AI视频、AI聊天、AI音乐

下载
一个终端或命令行工具： 比如macOS或Linux的Terminal、Windows的PowerShell或CMD。这是你输入
```
node
```
命令的地方。

这些都准备好，你就可以开始你的命令行JS之旅了。少了任何一个，都可能让你寸步难行。我个人觉得，Node.js的安装是唯一可能遇到点小麻烦的地方，但只要按照官方指引来，通常都非常顺利。

如何在Node.js脚本中获取命令行参数？

脚本跑起来之后，我们经常需要给它一些外部输入，比如配置信息、操作目标等等。这时候，命令行参数就派上用场了。Node.js提供了一个全局对象

process

，其中有个

argv

属性，专门用来处理这些参数。

process.argv

是一个数组，它包含了所有在命令行中传递给Node.js进程的参数。但这里有个小细节，我第一次用的时候也愣了一下：

```
process.argv[0]
```
：通常是
```
node
```
命令的完整路径。
```
process.argv[1]
```
：是你正在执行的JavaScript脚本文件的完整路径。
```
process.argv[2]
```
及以后：才是你真正传递给脚本的参数。

举个例子，假设你有一个

greet.js

文件：

// greet.js
const args = process.argv;

if (args.length > 2) {
    const name = args[2]; // 第一个实际参数
    const greeting = args[3] || "Hello"; // 第二个实际参数，如果没有则默认"Hello"
    console.log(`${greeting}, ${name}!`);
} else {
    console.log("Usage: node greet.js <name> [greeting]");
}

然后在命令行中这样执行：

node greet.js Alice
# 输出: Hello, Alice!

node greet.js Bob Hi
# 输出: Hi, Bob!

node greet.js
# 输出: Usage: node greet.js <name> [greeting]

这简直是命令行工具的基础。通过

process.argv

，你的脚本就有了和外界交互的能力，不再只是一个“死”的程序，而是能根据你的指令做出不同响应的“活”工具。我个人在写一些自动化脚本时，这个功能用得飞起，能让脚本的通用性大大提高。当然，如果参数很多或者很复杂，通常会考虑使用像

minimist

或

yargs

这样的第三方库来解析参数，它们能帮你处理命名参数、短参数、默认值等等，让代码更健壮。但

process.argv

是最基础、最直接的获取方式。

命令行执行JS脚本时，有哪些常见的挑战或进阶用法？

虽然在命令行里跑JS看起来很简单，但实际操作中，尤其是在项目里，还是会遇到一些需要注意的地方，或者说，有一些进阶的用法能让你的脚本更强大、更易用。

模块系统：CommonJS vs. ES Modules (ESM) 这是个老生常谈但又不得不提的问题。Node.js最初使用的是CommonJS模块系统（
```
require()
```
和
```
module.exports
```
），但随着ES Modules（
```
import
```
和
```
export
```
）成为JavaScript的标准，Node.js也开始支持ESM。
- 默认行为： 如果你的文件是
```
.js
```
  扩展名，Node.js会默认将其视为CommonJS模块。
- 启用ESM：
  - 将文件扩展名改为
```
.mjs
```
    。
  - 在
```
package.json
```
    中添加
```
"type": "module"
```
    ，这样项目中的所有
```
.js
```
    文件都会被视为ESM。
- 混合使用： 在ESM中可以使用
```
import()
```
  动态导入CommonJS模块，但在CommonJS中不能直接使用
```
import
```
  语句。这块有时候会让人有点头疼，尤其是在处理一些老旧库的时候。我的经验是，如果从头开始一个新项目，尽量统一用ESM，能省去不少麻烦。
错误处理与退出码 在命令行里跑脚本，错误处理非常关键。一个健壮的脚本应该能优雅地处理错误，并返回一个有意义的退出码（exit code）。
- try...catch
  ：处理同步代码中的错误。
- Promise的
  .catch()
  ：处理异步操作中的错误。
- process.exit(code)
  ：这是关键。
  - ```
  process.exit(0)
```
  ：表示脚本成功执行。
- ```
process.exit(1)
```
    或其他非零值：表示脚本执行失败。这个退出码对于自动化脚本、CI/CD流水线来说非常重要，它能告诉外部系统脚本是否成功完成任务。我写自动化脚本时，总是会确保在遇到不可恢复的错误时，脚本能返回非零退出码。
```
// error_example.js
try {
    // 模拟一个错误
    throw new Error("Something went wrong!");
} catch (error) {
    console.error("Caught an error:", error.message);
    process.exit(1); // 脚本以失败状态退出
}
console.log("This line will not be reached if an error occurs.");
```
执行
```
node error_example.js
```
，你会看到错误信息，并且脚本会以非零状态退出。
异步操作的处理 Node.js是基于事件循环和非阻塞I/O的，这意味着很多操作都是异步的。如果你在脚本中执行文件读写、网络请求等操作，需要确保脚本在所有异步任务完成之后才退出。
- async/await
  ：这是处理异步操作最现代、最优雅的方式。确保你的主逻辑函数是
```
async
```
  的，并且等待所有
```
await
```
  的Promise完成。
- Promise链： 传统上使用
```
.then().catch()
```
  链式调用。如果脚本在异步任务完成前就退出了，那结果就可能不完整或不正确。这是Node.js初学者常犯的错误之一。我记得有一次，我的脚本在处理完所有数据前就退出了，找了半天才发现是异步逻辑没处理好。
Shebang (Hashbang) 和脚本可执行化 在Linux或macOS系统中，你可以在脚本文件的第一行添加一个特殊的注释，称为Shebang（
```
#!
```
），来指定执行该脚本的解释器。这样，你就可以直接运行脚本，而不需要显式地写
```
node
```
命令。
```
#!/usr/bin/env node
// my_executable_script.js
console.log("This script runs directly!");
```
要让它直接运行，还需要给文件添加执行权限：
```
chmod +x my_
```