用 JavaScript 写命令行工具需借助 Node.js 环境,关键步骤包括:添加 shebang、设执行权限或配置 package.json 的 bin 字段并 npm link/install -g;通过 process.argv 获取参数;常用内置模块有 fs、path、process、os、child_process、readline、util。

用 JavaScript 写命令行工具,核心是靠 Node.js 提供的运行环境和内置模块。不需要额外编译,写完就能通过 node xxx.js 或封装成可执行命令直接运行。
怎么让 JS 文件变成命令行命令
关键几步:
- 在文件开头加
#!/usr/bin/env node(Linux/macOS 生效,Windows 一般忽略但不影响) - 给文件加执行权限:
chmod +x cli.js(macOS/Linux),然后直接运行./cli.js - 或更通用的方式:在
package.json中配置"bin"字段,比如:"bin": { "mytool": "./index.js" },再执行npm link(开发时)或npm install -g(全局安装),之后终端就能直接输入mytool运行 - 用
process.argv获取命令行参数(argv[0]是 node 路径,argv[1]是脚本路径,实际参数从argv[2]开始) - 推荐用现成库简化开发,比如
commander(定义命令、选项、帮助文案很顺手)、inquirer(交互式提问)、chalk(彩色输出)
Node.js 常用内置模块有哪些
这些模块不用安装,require 就能用,是写命令行工具最常打交道的:
- fs:读写文件、判断路径、复制删除等,命令行工具经常要处理配置文件或生成代码
-
path:拼接、解析、规范化路径(比如
path.join(__dirname, 'config.json')),跨平台安全 -
process:获取环境变量(
process.env)、命令行参数(process.argv)、退出进程(process.exit())、监听信号(如process.on('SIGINT', ...)) -
os:获取操作系统信息(CPU 数、临时目录
os.tmpdir()、换行符os.EOL) -
child_process:运行其他命令(比如调用 git、curl、本地脚本),常用
execSync(同步阻塞)或spawn(流式处理) - readline:逐行读取用户输入(适合做 REPL 或交互式向导)
-
util:提供实用函数,比如
util.promisify()把回调转 Promise,util.inspect()美化打印对象
一个最小可用示例
新建 hello.js:
立即学习“Java免费学习笔记(深入)”;
#!/usr/bin/env node
const { argv } = process;
if (argv.length < 3) {
console.log('用法:hello <名字>');
process.exit(1);
}
console.log(`你好,${argv[2]}!`);
终端执行:chmod +x hello.js && ./hello 张三 → 输出 “你好,张三!”
基本上就这些。不复杂但容易忽略细节,比如路径处理、参数解析、错误提示和跨平台兼容性——把内置模块用熟,再搭配一两个流行 CLI 库,就能写出专业又易用的工具。











