docs: 完善 build.sh 使用说明注释

backend/build.sh

@@ -4,7 +4,41 @@
 # 功能说明：快速编译打包后端项目，支持多线程、增量、模块化编译
 # 作    者：湖北新华业务中台研发团队
 # 创建时间：2026-02-02
-# 使用方法：./build.sh [选项]
+# ============================================================
+#
+# 【优化策略】
+#   - 多线程编译：-T 1C 使用全部CPU核心并行编译
+#   - 增量编译：不执行 clean，复用已编译的 class 文件
+#   - 模块化编译：-pl :module -am 仅编译指定模块及其依赖
+#   - 静默模式：-q 减少日志输出，加快速度
+#   - JVM优化：-XX:TieredStopAtLevel=1 编译器快速模式
+#
+# 【使用方法】
+#   ./build.sh [选项]
+#
+# 【选项说明】
+#   -q, --quick    快速编译（仅 compile，检查语法错误，最快）
+#   -p, --package  增量打包（package，不 clean，默认选项）
+#   -f, --full     全量编译（clean + package）
+#   -m, --module   指定模块编译（如: -m pangu-business）
+#   -r, --restart  编译后重启后端服务
+#   -c, --clean    仅清理 target 目录
+#   -h, --help     显示帮助信息
+#
+# 【常用示例】
+#   ./build.sh -q              # 快速编译，仅检查语法（约4秒）
+#   ./build.sh -p              # 增量打包（约4秒）
+#   ./build.sh -f              # 全量编译（约30秒）
+#   ./build.sh -m pangu-business       # 仅编译业务模块
+#   ./build.sh -m pangu-business -r    # 编译业务模块并重启（约27秒）
+#   ./build.sh -r              # 增量打包并重启
+#
+# 【开发建议】
+#   1. 日常开发：修改代码后用 -q 快速检查语法错误
+#   2. 本地测试：用 -r 编译并重启服务
+#   3. 仅改某模块：用 -m 指定模块，加快编译速度
+#   4. 部署前：用 -f 全量编译确保干净
+#
 # ============================================================
 set -e