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

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

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

node

node your_script.js

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

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

brew install node

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

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

输入

.exit

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

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

具体来说，你需要：

1. 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一起安装，它是管理项目依赖的利器。

2. 一个文本编辑器： 用来编写你的JavaScript代码。VS Code、Sublime Text、Atom，甚至记事本都行，只要能保存为

   .js

   文件就行。
   

   JTBC网站内容管理系统5.0.3.1

   JTBC CMS(5.0) 是一款基于PHP和MySQL的内容管理系统原生全栈开发框架，开源协议为AGPLv3，没有任何附加条款。系统可以通过命令行一键安装，源码方面不基于任何第三方框架，不使用任何脚手架，仅依赖一些常见的第三方类库如图表组件等，您只需要了解最基本的前端知识就能很敏捷的进行二次开发，同时我们对于常见的前端功能做了Web Component方式的封装，即便是您仅了解HTML/CSS也

   下载

3. 一个终端或命令行工具： 比如macOS或Linux的Terminal、Windows的PowerShell或CMD。这是你输入

   node

   命令的地方。

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

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

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

process

argv

process.argv

• 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  [greeting]");
}

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

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

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

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

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

process.argv

minimist

yargs

process.argv

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

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

1. 模块系统：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，能省去不少麻烦。

2. 错误处理与退出码 在命令行里跑脚本，错误处理非常关键。一个健壮的脚本应该能优雅地处理错误，并返回一个有意义的退出码（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

   ，你会看到错误信息，并且脚本会以非零状态退出。

3. 异步操作的处理 Node.js是基于事件循环和非阻塞I/O的，这意味着很多操作都是异步的。如果你在脚本中执行文件读写、网络请求等操作，需要确保脚本在所有异步任务完成之后才退出。

   • async/await

     ： 这是处理异步操作最现代、最优雅的方式。确保你的主逻辑函数是

     async

     的，并且等待所有

     await

     的Promise完成。
   • Promise链： 传统上使用

     .then().catch()

     链式调用。 如果脚本在异步任务完成前就退出了，那结果就可能不完整或不正确。这是Node.js初学者常犯的错误之一。我记得有一次，我的脚本在处理完所有数据前就退出了，找了半天才发现是异步逻辑没处理好。

4. Shebang (Hashbang) 和脚本可执行化 在Linux或macOS系统中，你可以在脚本文件的第一行添加一个特殊的注释，称为Shebang（

   #!

   ），来指定执行该脚本的解释器。这样，你就可以直接运行脚本，而不需要显式地写

   node

   命令。

   #!/usr/bin/env node
   // my_executable_script.js
   console.log("This script runs directly!");

   要让它直接运行，还需要给文件添加执行权限：

   chmod +x my_