Bazel Python单体仓库嵌套库结构配置咨询

目录结构合理性 #

• 你的方案完全可行，甚至是Bazel生态里推荐的模块化思路：将可部署的业务项目与复用性强的库代码分离，库按业务主题（比如Django的view、model）拆分嵌套目录，能清晰划分代码职责，方便后续的依赖管理和代码复用。
• 你提到的嵌套目录用空BUILD文件是正确操作，空BUILD文件的作用是告诉Bazel“这个目录是一个包的边界”，避免Bazel无差别扫描整个目录树，同时让子目录的BUILD规则能被正确识别。

工作区规划：无需独立工作区 #

• 不需要给libraries和projects分别设置独立工作区。单体仓库本身就是一个完整的Bazel工作区（由根目录的WORKSPACE文件标记），将所有模块放在同一工作区内，能让Bazel更高效地处理跨模块依赖引用，避免多工作区带来的依赖同步麻烦。

BUILD.bazel配置示例 #

推荐的目录结构 #

your-monorepo/
├── WORKSPACE
├── requirements.txt
├── projects/
│   ├── django_demo/
│   │   ├── BUILD.bazel
│   │   └── manage.py
└── libraries/
    ├── django/
    │   ├── BUILD.bazel  # 空文件，标记包边界
    │   ├── view/
    │   │   ├── BUILD.bazel
    │   │   └── render_utils.py
    │   └── model/
    │       ├── BUILD.bazel
    │       └── base.py

库模块配置（libraries/django/view/BUILD.bazel） #

py_library(
    name = "render_utils",
    srcs = ["render_utils.py"],
    # 限制可见性，只允许projects下的模块引用
    visibility = ["//projects:__subpackages__"],
    deps = [
        # 依赖同目录下的model模块
        "//libraries/django/model:base",
    ],
)

可部署项目配置（projects/django_demo/BUILD.bazel） #

py_binary(
    name = "demo_app",
    srcs = ["manage.py"],
    main = "manage.py",
    deps = [
        "//libraries/django/view:render_utils",
        "//libraries/django/model:base",
        # 引用第三方Django依赖（需在WORKSPACE中声明）
        "@pypi//django",
    ],
)

WORKSPACE核心配置（处理第三方依赖） #

# 引入rules_python规则集
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

http_archive(
    name = "rules_python",
    url = "https://github.com/bazelbuild/rules_python/releases/download/0.25.0/rules_python-0.25.0.tar.gz",
    sha256 = "a1b2c3d4e5f6...",  # 替换为对应版本的校验值
)

# 注册Python工具链
load("@rules_python//python:repositories.bzl", "python_register_toolchains")
python_register_toolchains(
    name = "python3_11",
    python_version = "3.11",
)

# 解析pip依赖
load("@rules_python//python:pip.bzl", "pip_parse")
pip_parse(
    name = "pypi",
    requirements_lock = "//:requirements.txt",
)

load("@pypi//:requirements.bzl", "install_deps")
install_deps()

实用参考方向 #

• 通读Bazel官方Python规则文档：重点掌握py_library、py_binary的参数含义，尤其是visibility、deps这类核心配置
• 学习Bazel官方单体仓库实践指南：了解单体仓库下模块划分、依赖隔离的最佳实践
• 参考开源项目的Bazel配置：找几个用Bazel管理Python代码的开源项目，直接看他们的目录结构和BUILD文件写法

内容的提问来源于stack exchange，提问作者Ibolit