ts-proto项目中的Shell脚本通配符问题解析

在ts-proto项目使用过程中，开发者可能会遇到一个有趣的Shell脚本执行差异问题：当直接在终端执行protoc命令时能够正确处理所有.proto文件，但将相同命令放入Shell脚本后却只能处理部分文件。这种现象背后隐藏着Shell解释器的行为差异和通配符扩展机制。

问题现象分析

开发者描述的具体场景是：

• 直接终端执行命令能正确处理241个.proto文件
• 放入Shell脚本后仅处理79个文件
• 环境为MacBook Pro M1Pro

这种差异主要源于不同Shell解释器对通配符的处理方式不同。在macOS系统中，/bin/sh实际上是bash的兼容模式，而终端默认使用/bin/bash的完整功能模式。

技术原理

1. 通配符扩展机制：

   • **是bash 4.0+引入的"globstar"特性
   • 在传统sh模式下，**不会被识别为递归匹配符
   • 即使使用bash，默认情况下也需要显式启用globstar选项

2. Shell解释器差异：

   • /bin/sh通常以POSIX兼容模式运行
   • /bin/bash提供更多扩展功能
   • macOS系统上/bin/sh实际是bash的POSIX兼容模式

解决方案

1. 推荐方案： 修改脚本shebang为#!/bin/bash并启用globstar：

   #!/bin/bash
   shopt -s globstar
   protoc --plugin=./node_modules/ts-proto/protoc-gen-ts_proto \
          --ts_proto_opt=forceLong=string \
          --ts_proto_opt=onlyTypes=true \
          --ts_proto_opt=snakeToCamel=false \
          --ts_proto_out=./out-ts \
          -I=${APP_DIR} \
          ${APP_DIR}/**/*.proto
   

2. 替代方案： 如果必须使用sh，可以采用分层处理方式：

   #!/bin/sh
   # 一级目录处理
   protoc [options] ${APP_DIR}/*.proto
   # 二级目录处理
   protoc [options] ${APP_DIR}/*/*.proto
   

深入理解

1. globstar特性：

   • 启用后**可以匹配任意层级的子目录
   • 需要bash 4.0+版本支持
   • 在脚本中需显式启用：shopt -s globstar

2. Shell兼容性考虑：

   • 编写可移植脚本时应考虑目标环境的Shell特性
   • 可以在脚本开头检测Shell类型和版本
   • 对于复杂通配需求，考虑使用find命令替代

3. protoc命令最佳实践：

   • 复杂项目建议使用protobuf项目文件列表
   • 可以考虑使用构建工具(gulp/grunt)管理编译过程
   • 大型项目可拆分proto文件到不同目录分别处理

总结

这个案例展示了Shell脚本编写中常见的环境差异问题。理解不同Shell解释器的特性差异、通配符扩展机制以及protoc命令的文件处理方式，对于构建可靠的前端构建流程非常重要。在ts-proto项目使用中，确保执行环境的一致性可以避免这类问题的发生。

对于跨平台项目，建议在文档中明确Shell环境要求，或者采用更可靠的替代方案如显式文件列表来确保构建一致性。