本文详细介绍了在bazel项目中如何正确导入定义在不同目标（target）中的python模块。核心在于理解bazel的构建规则，特别是区分`srcs`和`deps`的使用场景。通过清晰的`build`文件配置示例和python代码演示，文章将指导开发者正确声明跨包依赖，并使用正确的导入路径，从而有效解决bazel python模块间的引用问题，确保项目结构清晰且可维护。
在复杂的Python项目中，尤其当采用Bazel作为构建系统时，管理跨多个Bazel目标（target）或包（package）的模块导入是一个常见的挑战。不正确的依赖声明和导入路径会导致构建失败或运行时错误。本教程旨在提供一套清晰的指导，帮助开发者理解并正确实现Bazel Python模块的跨目标导入。
理解Bazel中的Python模块与依赖
Bazel通过py_library和py_binary等规则来构建Python项目。理解它们如何处理源代码和依赖关系至关重要。
- py_library: 用于定义可供其他Bazel目标引用的Python库。它将指定的Python源文件打包成一个可导入的单元。
- py_binary: 用于定义可执行的Python程序。它通常依赖一个或多个py_library。
- srcs 属性: 用于指定当前目标直接包含的源文件。这些文件将被编译或打包到当前目标中。
- deps 属性: 用于声明当前目标所依赖的其他Bazel目标。当一个目标依赖另一个py_library时，Bazel会确保被依赖库的Python模块在运行时可被导入。
关键区别: srcs用于“拥有”源代码，而deps用于“引用”其他目标提供的功能。对于跨包的Python模块引用，务必使用deps来声明依赖，而不是试图通过srcs直接包含其他包的源文件。Bazel会负责将deps中声明的库添加到PYTHONPATH中，使其在运行时可被导入。
项目结构概览
假设我们有一个典型的Bazel Python项目结构，包含两个独立的Python包：bedrock 和 boilerplate。boilerplate包中的代码需要导入bedrock包中的某个模块。
立即学习“Python免费学习笔记（深入）”；
.
├── bedrock
│ ├── BUILD
│ └── bedrock
│ ├── __init__.py
│ └── main.py
└── boilerplate
├── BUILD
└── main.py在这个结构中：
- bedrock/bedrock/main.py 定义了一个函数，我们希望在 boilerplate/main.py 中调用。
- bedrock 目录本身是一个Bazel包（因为有 BUILD 文件）。
- bedrock/bedrock 目录是一个Python包（因为有 __init__.py 文件）。
构建规则的正确配置
首先，我们需要为bedrock包定义一个py_library目标，使其可以被其他包依赖。
bedrock/BUILD 文件内容：
package(default_visibility = ["//visibility:public"])
py_library(
name = "main",
srcs = ["bedrock/main.py"], # 指定库包含的Python源文件
visibility = ["//visibility:public"], # 声明此库可被所有其他包访问
)说明:
- name = "main": 定义了一个名为main的py_library目标。完整的Bazel标签是//bedrock:main。
- srcs = ["bedrock/main.py"]: 将bedrock/main.py文件作为此库的一部分。如果__init__.py也需要，可以一并加入。
- visibility = ["//visibility:public"]: 这是一个重要的声明，它允许其他Bazel包（如boilerplate）依赖此bedrock:main目标。如果没有此声明，其他包将无法访问它。
接下来，为boilerplate包定义一个py_binary目标，并正确声明对bedrock库的依赖。
boilerplate/BUILD 文件内容：
py_binary(
name = "main",
main = "main.py", # 指定二进制入口文件
srcs = ["main.py"], # 当前二进制目标自身的源文件
deps = ["//bedrock:main"], # 声明对bedrock库的依赖
)说明:
- deps = ["//bedrock:main"]: 这是核心所在。它告诉Bazel，//boilerplate:main这个二进制目标需要//bedrock:main库在运行时可用。Bazel会自动将bedrock包的根目录添加到PYTHONPATH中，使得bedrock包中的模块可以被导入。
Python模块的实现与导入
现在，我们来编写Python代码。
bedrock/bedrock/main.py 文件内容：
def bedrock_function(): """A simple function defined in the bedrock module.""" return "Hello from bedrock!"
boilerplate/main.py 文件内容：
# 从bedrock包中的bedrock子包导入main模块
from bedrock.bedrock import main
if __name__ == "__main__":
# 调用从bedrock模块导入的函数
print(main.bedrock_function())说明:
- 导入路径 from bedrock.bedrock import main 是根据项目结构和Bazel的PYTHONPATH设置推导出来的。当//bedrock:main被添加到deps中时，Bazel会使bedrock（即包含bedrock/BUILD的目录）成为一个可导入的顶级包。因此，要访问bedrock/bedrock/main.py中的内容，路径就是bedrock.bedrock.main。
验证与运行
完成上述配置和代码编写后，我们可以使用Bazel来构建并运行boilerplate中的程序。
在工作区根目录执行以下命令：
bazel run //boilerplate:main
如果一切配置正确，你将看到如下输出：
INFO: Analyzed target //boilerplate:main (72 packages loaded, 597 targets configured). INFO: Found 1 target... Target //boilerplate:main up-to-date: bazel-bin/boilerplate/main INFO: Elapsed time: 0.272s, Critical Path: 0.00s INFO: 6 processes: 6 internal. INFO: Build completed successfully, 6 total actions INFO: Running command line: bazel-bin/boilerplate/main Hello from bedrock!
这表明boilerplate/main.py成功导入并调用了bedrock/bedrock/main.py中定义的bedrock_function。
注意事项
- visibility 属性: 确保你的py_library目标具有适当的visibility设置，以便其他包可以依赖它。"//visibility:public"允许任何包依赖，你也可以指定更具体的可见性规则。
- 导入路径: Python的导入路径是基于包结构的。当Bazel将一个库添加到PYTHONPATH时，它会添加该库的根目录。因此，你的from ... import ...语句必须反映实际的目录层级。
- 避免srcs滥用: 永远不要尝试将其他Bazel包的源文件直接添加到当前目标的srcs中。这会破坏Bazel的模块化和沙箱机制，并可能导致构建问题或不一致的行为。
- __init__.py文件: 确保你的Python包目录中包含__init__.py文件，以便Python将其识别为包。
总结
在Bazel中正确导入Python跨目标模块的核心在于理解和正确使用BUILD文件中的deps属性来声明依赖关系，并确保Python代码中的导入路径与项目结构以及Bazel生成的PYTHONPATH相匹配。通过遵循这些最佳实践，开发者可以构建出结构清晰、依赖明确且易于维护的Bazel Python项目。
