C++ 和 Bazel

报告问题 查看源代码

本页面包含可帮助您将 Bazel 与 C++ 项目结合使用的资源。其中提供了教程、构建规则以及关于如何使用 Bazel 构建 C++ 项目的其他信息的链接。

使用 Bazel

以下资源可帮助您在 C++ 项目中使用 Bazel：

最佳实践

除了常规 Bazel 最佳实践之外，以下是特定于 C++ 项目的最佳实践。

build 文件

创建 BUILD 文件时，请遵循以下准则：

  • 每个 BUILD 文件都应在目录中每个编译单元包含一个 cc_library 规则目标。

  • 您应该尽可能细化 C++ 库，以最大限度地提高增量并并行构建。

  • 如果 srcs 中存在单个源文件，请使用与该 C++ 文件相同的名称来命名库。此库应包含 C++ 文件、任何匹配的头文件，以及库的直接依赖项。例如：

    cc_library(
    name = "mylib",
    srcs = ["mylib.cc"],
    hdrs = ["mylib.h"],
    deps = [":lower-level-lib"]
)

  • 在文件中为每个 cc_library 目标使用一个 cc_test 规则目标。将目标文件命名为 [library-name]_test，将源文件命名为 [library-name]_test.cc。例如，上面显示的 mylib 库目标的测试目标将如下所示：

    cc_test(
    name = "mylib_test",
    srcs = ["mylib_test.cc"],
    deps = [":mylib"]
)

包含路径

请遵循以下有关包含路径的指南：

  • 使所有包含路径相对于工作区目录。

  • 对于非系统头文件，请使用带引号的 include (#include "foo/bar/baz.h")，而不是尖括号 (#include <foo/bar/baz.h>)。

  • 避免使用 UNIX 目录快捷方式，例如 .（当前目录）或 ..（父目录）。

  • 对于需要指向项目代码库外部的旧版代码或 third_party 代码（例如外部代码库包含需要前缀），请对 cc_library 规则目标使用 include_prefix 和 strip_include_prefix 参数。