用 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:
标签: linux javascript java js node.js git json node windows 操作系统
还木有评论哦,快来抢沙发吧~