JS脚本在终端直接运行需shebang行#!/usr/bin/env node加chmod+x权限；process.argv应slice(2)后用minimist或commander解析；commander自动处理选项校验、子命令和帮助；bin字段须指向含shebang的可执行文件并确保发布包含该文件。
如何让 JS 脚本在终端里直接运行（不加 node）
关键在于可执行权限 + 正确的 shebang 行。Linux/macOS 下，脚本第一行必须是 #!/usr/bin/env node，且文件要有执行权限：chmod +x ./my-cli.js。Windows 不支持 shebang，所以这招只适用于类 Unix 系统；若需跨平台，建议用 package.json 的 bin 字段配合 npm link 安装。
process.argv 怎么安全地解析命令行参数
Node.js 原生的 process.argv 是个数组，[node路径, 脚本路径, ...args]，前两个元素永远存在，容易误读。别手动切数组，优先用成熟库如 minimist 或 commander——它们能自动处理短选项（-v）、长选项（--version）、子命令、类型转换和帮助信息生成。如果坚持手写，至少先做 process.argv.slice(2) 再处理，否则会把 node 和脚本名当参数。
为什么 commander 比裸写 if/else 更可靠
裸写逻辑容易漏掉边界情况：比如用户输入 mytool --help --verbose，或传入非字符串值（--port 3000），或拼错子命令却没提示建议。而 commander 自带参数校验、自动补全提示、版本输出、错误捕获和嵌套命令注册机制。例如定义一个子命令只需：
program
.command('build')
.description('build project')
.option('-w, --watch', 'watch files')
.action(() => { /* ... */ });它还能自动识别 mytool build --watch 并触发对应 action，不用自己 switch 判断。
立即学习“Java免费学习笔记（深入）”；
发布 CLI 工具时 bin 字段怎么配才不踩坑
package.json 中的 bin 必须指向一个有 shebang 且可执行的文件（如 ./bin/mytool），不能是 index.js。这个文件内容通常只有一行：#!/usr/bin/env node，然后 require('./lib/cli.js')。常见错误包括：
-
bin指向了未加 shebang 的 JS 文件 → 全局安装后执行报Permission denied或bad interpreter - 发布时没把
bin文件加入files字段 → npm publish 后全局 bin 找不到入口 - 本地测试用
npm link但忘了chmod +x→ 链接成功但执行失败
复杂点在于 Windows 用户看不到 shebang，但 npm 会自动注入包装器，所以只要 bin 配置正确，跨平台基本无感；真正容易被忽略的是发布前的文件打包验证——务必检查 npm pack 输出的 tarball 里是否真包含了 bin 指向的文件。
