# 基本构建bazel build //...                     # 构建所有目标bazel build //src:app                 # 构建特定目标bazel build //src/...                # 构建 src 包下所有目标# 构建选项bazel build //... -c opt              # 优化模式bazel build //... -c dbg              # 调试模式bazel build //... --config=release    # 使用自定义配置# 并发控制bazel build //... --jobs=8            # 8个并发任务bazel build //... --local_resources=8,12.0  # 8个CPU，12GB内存# 远程构建bazel build //... --remote_cache=grpc://cache:9092bazel build //... --remote_executor=grpc://executor:9091

# 基本测试bazel test //...                      # 运行所有测试bazel test //tests:unit_tests         # 运行特定测试bazel test //... --test_output=all    # 显示所有测试输出# 测试过滤bazel test //... --test_filter="*Test"         # 只运行Testbazel test //... --test_tags_filters=unit      # 只运行unit测试bazel test //... --test_size_filters=small     # 只运行小测试# 测试配置bazel test //... --test_timeout=300           # 总超时300秒bazel test //... --runs_per_test=3            # 每个测试运行3次

# 基本查询bazel query //...                     # 列出所有目标bazel query "kind(cc_library, //...)" # 查找所有库bazel query "deps(//:app)"           # 查询依赖# 高级查询bazel query "rdeps(//..., //:lib)"   # 查询反向依赖bazel query "somepath(//:a, //:b)"   # 查找路径bazel query --output=graph | dot -Tpng # 生成依赖图# cquery (配置查询)bazel cquery "kind(cc_binary, //...)" --output=label

# 构建分析bazel build //... --build_profile=json:profile.jsonbazel analyze-profile profile.json --output_html=analysis.html# 依赖分析bazel query --output=tree "deps(//:app)"bazel mod graph                          # Bzlmod 依赖图

http_archive(    name = "example_lib",    urls = [        "https://github.com/example/lib/archive/v1.0.tar.gz",    ],    sha256 = "...",    strip_prefix = "lib-1.0",    build_file = "//third_party:lib.BUILD",    patch_cmds = ["sed -i 's/foo/bar/' file.txt"],)

git_repository(    name = "example_lib",    remote = "https://github.com/example/lib.git",    branch = "main",    # 或    tag = "v1.0.0",    commit = "a1b2c3d4...",)

local_repository(    name = "local_lib",    path = "../lib",  # 相对路径)

# 模块定义module(    name = "my_project",    version = "1.0.0",    compatibility_level = 1,)# 依赖声明bazel_dep(name = "abseil-cpp", version = "20230802.1")bazel_dep(name = "rules_cc", version = "0.0.9")# 扩展声明bazel_dep(name = "my_extension", repo_name = "example")

# extensions.bzldef _my_extension_impl(module_ctx):    # 实现逻辑    passmy_extension = module_extension(    implementation = _my_extension_impl,)# 使用my_extension = use_extension("//:extensions.bzl", "my_extension")

# 安装go install github.com/bazelbuild/buildtools/buildifier@latest# 使用buildifier --version                           # 查看版本buildifier *.bzl BUILD WORKSPACE                # 格式化文件buildifier --lint=warn --mode=check *.bzl      # 检查语法# 配置buildifier --diff                              # 显示差异buildifier --fix                               # 自动修复

# 比较两次构建的差异bazel-diff \    --baseline=baseline \    --current=current \    --output-file=diff.txt

# 启动远程缓存服务器bazel-remote \    --max_storage=100GiB \    --host=localhost:9092 \    --storage_path=/cache/bazel-remote

# 1. 启用详细日志bazel build //... --verbose# 2. 检查缓存bazel info --disk_cache_usage# 3. 查看详细错误bazel build //... --verbose_failures# 4. 分析构建bazel analyze-profile --build

# 查看构建时间bazel build //... --experimental_show_spawn_timestamps# 分析 Action 时间bazel query --output=label "buildfiles(//...)" | \    xargs bazel build --action_env=VERBOSE=1# 监控资源使用top -p $(pgrep -f "bazel")

✅ 推荐的项目结构project/├── WORKSPACE / MODULE.bazel├── .bazelrc├── BUILD                    # 根包（可选）├── src/│   ├── BUILD│   ├── main.cc│   └── lib/├── lib/                     # 共享库│   ├── BUILD│   └── utils.h├── third_party/             # 第三方依赖│   ├── BUILD│   └── deps/├── tests/│   ├── BUILD│   └── unit/└── tools/                   # 构建工具    ├── buildifier/    └── scripts/

# ✅ 好的实践cc_library(    name = "public_api",    srcs = ["api.cc"],    hdrs = ["api.h"],    deps = [        "//base:types",        # 精确依赖    ],    visibility = ["//visibility:public"],)# ❌ 坏的实践cc_library(    name = "everything",    srcs = glob(["**/*.cc"]),   # 过于宽泛    deps = ["//base:*"],        # 过度依赖)

✅ 依赖管理原则─────────────────────────1. 始终显式声明依赖2. 使用版本锁定3. 依赖粒度适中4. 避免过度抽象5. 定期更新依赖6. 使用镜像源