技能介绍

告别 Bash 引号地狱

当命令行脚本突破三十行，或开始涉及复杂的字符串拼接与多重条件分支时，原生 Bash 的维护成本会急剧上升。引号转义混乱、错误处理缺失以及难以阅读的语法，往往让原本简单的自动化任务变成排查痛苦的源头。本技能面向被这些问题折磨过的工程师，主张在脚本规模和复杂度达到临界点时，转向 JavaScript/TypeScript 生态。

zx 脚本编写五步法

基于 zx 的设计，该指南将命令行编排转化为可读、可测的工程代码。其核心方法论包含五个关键步骤：

声明解释器：在脚本首行使用 #!/usr/bin/env zx 并赋予执行权限，从而获得顶层 await 的支持。
调用与管道：通过 await $command 执行外部命令，返回包含 stdout、stderr 和 exitCode 的对象，天然支持管道操作。
分级错误处理：利用 try/catch 捕获致命错误，或使用 .nothrow() 处理预期内的失败，避免脚本静默吞错。
输出解析与集成：结合 chalk 进行终端上色、使用 fs 读写文件及 glob 遍历目录，将命令输出无缝接入 JS 逻辑。
参数与配置管理：通过 argv 读取输入，敏感信息严格走环境变量，杜绝硬编码。

适用边界与避坑指南

虽然 zx 能显著提升脚本的工程化水平，但使用时仍需注意几个关键陷阱。切勿忘记 await，否则后续步骤会在命令未完成时提前执行；在模板字符串中传递变量时，务必注意 ${} 的 JS 求值特性，防范命令注入风险；此外，zx 是 JS 运行时而非 Bash 解释器，循环与判断必须使用 JS 语法，严禁混用 if [ ... ]。对于涉及生产环境或 CI/CD 流水线的脚本，建议先在隔离环境中充分验证，并锁定 zx 的版本依赖。