Python 和 TypeScript CLI先统一退出码与输出通道CLI 好不好接进脚本不在于颜色多漂亮而在于成功、失败和机器可读输出是否稳定。Python 与 TypeScript 都能做好工具关键是契约一致。标准输出只放结果进度和诊断写到 stderr业务结果写 stdout需要自动化时提供 JSON 模式。退出码区分成功、参数错误、依赖失败和权限不足调用方不必解析中文文案。import json import sys def emit_error(code: str, message: str, exit_code: int) - None: print(json.dumps({error: code, message: message}, ensure_asciiFalse), filesys.stderr) raise SystemExit(exit_code)配置优先级要明确命令行参数覆盖环境变量环境变量覆盖配置文件默认值最后生效。密钥不进入历史记录和日志。路径参数在执行前解析并校验危险操作提供预览或显式确认。测试像用户一样调用覆盖帮助、缺参、管道、无 TTY、取消和依赖不可用。对 stdout、stderr 与退出码分别断言避免内部重构悄悄破坏脚本调用。CLI 是给人用的接口也是给自动化用的 API。输出边界稳住语言选择反而没那么重要。 Python 和 TypeScript CLI先统一退出码与输出通道CLI 好不好接进脚本不在于颜色多漂亮而在于成功、失败和机器可读输出是否稳定。Python 与 TypeScript 都能做好工具关键是契约一致。标准输出只放结果进度和诊断写到 stderr业务结果写 stdout需要自动化时提供 JSON 模式。退出码区分成功、参数错误、依赖失败和权限不足调用方不必解析中文文案。import json import sys def emit_error(code: str, message: str, exit_code: int) - None: print(json.dumps({error: code, message: message}, ensure_asciiFalse), filesys.stderr) raise SystemExit(exit_code)配置优先级要明确命令行参数覆盖环境变量环境变量覆盖配置文件默认值最后生效。密钥不进入历史记录和日志。路径参数在执行前解析并校验危险操作提供预览或显式确认。测试像用户一样调用覆盖帮助、缺参、管道、无 TTY、取消和依赖不可用。对 stdout、stderr 与退出码分别断言避免内部重构悄悄破坏脚本调用。CLI 是给人用的接口也是给自动化用的 API。输出边界稳住语言选择反而没那么重要。 
)
