# 定义一个高级宏def cc_library_with_logging(name, **kwargs):    """创建一个带日志功能的库"""    kwargs.setdefault("copts", []).extend(["-DLOG_ENABLE"])    kwargs.setdefault("deps", []).append("//base:logging")    native.cc_library(name = name, **kwargs)# 使用宏cc_library_with_logging(    name = "feature_x",    srcs = ["feature_x.cc"],    hdrs = ["feature_x.h"],)# 参数化宏def generate_api_library(name, api_version, **kwargs):    kwargs.setdefault("defines", []).append(f"API_VERSION={api_version}")    kwargs.setdefault("visibility", ["//visibility:public"])    native.cc_library(name = name, **kwargs)# 使用generate_api_library(name = "api_v2", api_version = "2.0")

# 条件赋值if ctx.attr.enable_debug:    copts = ["-g", "-DDEBUG"]else:    copts = ["-O3", "-DNDEBUG"]# 循环all_srcs = []for src in ctx.files.srcs:    all_srcs.append(src)# 函数def get_compile_flags(compilation_mode):    flags = {        "fastbuild": ["-Og"],        "dbg": ["-g", "-O0"],        "opt": ["-O3"],    }    return flags.get(compilation_mode, [])# 使用copts = get_compile_flags(ctx.attr.compilation_mode)

# 自定义规则定义def _my_cc_rule_impl(ctx):    # 创建输出文件    output = ctx.actions.declare_file(ctx.label.name + ".o")    # 执行编译    ctx.actions.run(        inputs = ctx.files.srcs,        outputs = [output],        executable = ctx.executable.compiler,        arguments = ctx.files.srcs + [output.path],    )    return [DefaultInfo(files = depset([output]))]# 注册自定义规则my_cc_rule = rule(    implementation = _my_cc_rule_impl,    attrs = {        "srcs": attr.label_list(allow_files = [".cc"]),        "compiler": attr.label(            default = Label("@local_config_cc//:compiler"),            executable = True,            allow_files = True,        ),    },)

# 1. 减少 Action 数量# ❌ 创建多个小库cc_library(name = "a", srcs = ["a.cc"])cc_library(name = "b", srcs = ["b.cc"])cc_library(name = "combined", deps = [":a", ":b"])# ✅ 合并为一个大库cc_library(name = "combined", srcs = ["a.cc", "b.cc"])# 2. 使用实现依赖cc_library(    name = "public_api",    hdrs = ["api.h"],    deps = ["//base:types"],  # 公共依赖    implementation_deps = [        "//core:internal",    # 实现依赖，不传播    ],)# 3. 合并相似的编译选项cc_library(    name = "lib",    srcs = glob(["*.cc"]),    copts = [        "-Wall",        "-Wextra",        "-Werror",        # 对特定文件使用不同选项    ] + select({        "**/*_test.cc": ["-DTESTING"],        "//conditions:default": [],    }),)

# 使用内容哈希而非文件名cc_library(    name = "versioned_lib",    srcs = ["lib.cc"],    copts = ["-DVERSION=(cat VERSION)/g' $(<) > $(@)    """,)# 使用生成的头文件cc_library(    name = "main_lib",    srcs = ["main.cc"],    hdrs = [":generated_headers"],)

# Protocol Buffers 支持proto_library(    name = "person_proto",    srcs = ["person.proto"],)cc_proto_library(    name = "person_proto_cc",    deps = [":person_proto"],)cc_library(    name = "person_utils",    deps = [":person_proto_cc"],)

# 集成代码生成工具genrule(    name = "generated_code",    srcs = ["spec.yaml"],    outs = ["generated_code.cc"],    tools = ["@my_codegen//:tool"],    cmd = "(<) --output {{ runner.os }}-bazel-{{ runner.os }}-bazel-      - name: Build        run: |          bazel build --config={{ matrix.config }} --test_output=all          if [[ "{{ matrix.config }} //tests:benchmark_test          fi      - name: Upload results        uses: actions/upload-artifact@v2        if: always()        with:          name: {{ matrix.os }}  strategy:    matrix:      os: [ubuntu-latest, windows-latest, macos-latest]      include:        - os: windows-latest          toolchain: msvc        - os: ubuntu-latest          toolchain: gcc        - os: macos-latest          toolchain: clang  steps:    - uses: actions/checkout@v3    - uses: bazelbuild/setup-bazelisk@v1    - name: Build      run: |        if [[ "${{ matrix.toolchain }}" == "msvc" ]]; then          bazel build --config=windows //...        else          bazel build //...        fi

# tests/integration_test.pyimport subprocessimport jsonimport osdef run_integration_test():    # 启动服务    service = subprocess.Popen(["./bazel-bin/server"])    try:        # 运行客户端测试        result = subprocess.run(            ["./bazel-bin/client", "--test-url=http://localhost:8080"],            capture_output=True,            text=True        )        if result.returncode != 0:            print(f"Test failed: {result.stderr}")            return False        else:            print("Test passed")            return True    finally:        # 清理        service.terminate()        service.wait()if __name__ == "__main__":    success = run_integration_test()    exit(0 if success else 1)

# 生成构建分析报告bazel build //... --experimental_action_cache=local \    --experimental_repository_cache=local \    --build_profile=json:build_profile.json# 转换为可读格式bazel analyze-profile build_profile.json --output_html=analysis.html

# cache_analyzer.pyimport jsonimport sysfrom collections import defaultdictdef analyze_cache():    with open("cache_stats.json", "r") as f:        stats = json.load(f)    # 分析 Action 缓存命中    action_hits = 0    action_misses = 0    for action in stats["actions"]:        if action["hit"]:            action_hits += 1        else:            action_misses += 1    print(f"Action Cache Hit Rate: {action_hits/(action_hits + action_misses)*100:.2f}%")    # 分析测试缓存    test_cache = stats.get("test_cache", {})    print(f"Test Cache Size: {test_cache.get('size', 0)} MB")    print(f"Test Cache Hits: {test_cache.get('hits', 0)}")if __name__ == "__main__":    analyze_cache()

# monitor.pyimport timeimport psutilimport subprocessclass BuildMonitor:    def __init__(self):        self.start_time = time.time()        self.cpu_percent = []        self.memory_usage = []    def log_metrics(self):        cpu = psutil.cpu_percent()        memory = psutil.virtual_memory().percent        self.cpu_percent.append(cpu)        self.memory_usage.append(memory)        with open("build_metrics.log", "a") as f:            f.write(f"{time.time() - self.start_time},{cpu},{memory}\n")    def get_summary(self):        return {            "avg_cpu": sum(self.cpu_percent) / len(self.cpu_percent),            "max_cpu": max(self.cpu_percent),            "avg_memory": sum(self.memory_usage) / len(self.memory_usage),            "max_memory": max(self.memory_usage),        }# 使用monitor = BuildMonitor()while True:    monitor.log_metrics()    time.sleep(1)

✅ 原则                          ❌ 反模式────────────────────────────    ─────────────────────────依赖图必须是有向无环图            循环依赖显式声明所有依赖                 隐式依赖编译单元保持较小                 巨大的编译单元使用内容哈希而不是时间戳          时间依赖的构建重复的代码应该抽象               重复的代码

# 1. 精确依赖# ❌ 过度依赖cc_library(    name = "lib",    deps = [        "//base:*",        "//core:*",    ],)# ✅ 精确依赖cc_library(    name = "lib",    deps = [        "//base:types",        "//core:utils",    ],)# 2. 优化编译选项# 针对特定文件优化srcs = select({    "**/performance_*.cc": ["-O3"],    "//conditions:default": ["-O2"],})# 3. 合并 Actioncc_library(    name = "combined",    srcs = ["a.cc", "b.cc", "c.cc"],    # 而不是    # cc_library(name = "a", srcs = ["a.cc"])    # cc_library(name = "b", srcs = ["b.cc"]))

项目结构示例：project/├── BUILD                            # 根包├── README.md├── src/                             # 源代码│   ├── BUILD│   ├── module1/│   │   ├── BUILD│   │   ├── module1.h│   │   └── module1.cc│   └── module2/│       ├── BUILD│       ├── module2.h│       └── module2.cc├── lib/                            # 共享库│   ├── BUILD│   ├── shared_types.h│   └── shared_utils.cc├── tests/                          # 测试│   ├── BUILD│   ├── unit/│   │   ├── BUILD│   │   └── test_*.cc│   └── integration/│       ├── BUILD│       └── test_*.cc├── tools/                          # 构建工具│   ├── BUILD│   ├── codegen/│   └── linter/├── configs/                        # 配置文件│   ├── .bazelrc│   └── build_defs/└── docs/                           # 文档    ├── BUILDING.md    └── API.md