本页介绍了 Bazel 的两个可见性系统：目标可见性和加载可见性。
这两种可见性有助于其他开发者区分库的公共 API 及其实现细节，并有助于在您的工作区不断扩大时强制执行结构。您还可以在废弃公共 API 时使用可见性，以允许当前用户使用该 API，同时拒绝新用户使用该 API。
目标公开范围
目标可见性用于控制哪些人可以依赖您的目标，也就是说，哪些人可以在 deps 等属性中使用目标的标签。
如果目标 A 和目标 B 位于同一软件包中，或者 A 向 B 的软件包授予了可见性，则 A 对 B 是可见的。因此，软件包是决定是否允许访问的精细度单位。如果 B 依赖于 A，但 A 对 B 不可见，则在分析期间，任何尝试构建 B 的操作都会失败。
请注意，向软件包授予可见性本身并不会向其子软件包授予可见性。如需详细了解软件包和子软件包，请参阅概念和术语。
如需进行原型设计，您可以通过设置标志 --check_visibility=false 来停用目标可见性强制执行。请勿在提交的代码中将其用于正式版。
控制可见性的主要方法是使用规则目标上的 visibility 属性。本部分介绍了此属性的格式，以及如何确定目标的公开范围。
公开范围规范
所有规则目标都有一个 visibility 属性，该属性接受标签列表。每个标签都具有以下形式之一。除了最后一种形式外，这些都只是语法占位符，与任何实际目标都不对应。
"//visibility:public"：授予对所有软件包的访问权限。（不得与任何其他规范组合使用。）"//visibility:private"：不会授予任何其他访问权限；只有此软件包中的目标才能使用此目标。（不得与任何其他规范组合使用。）"//foo/bar:__pkg__"：授予对//foo/bar（但不包括其子软件包）的访问权限。"//foo/bar:__subpackages__"：授予对//foo/bar及其所有直接和间接子软件包的访问权限。"//some_pkg:my_package_group"：授予对给定package_group中的所有软件包的访问权限。- 软件包组使用不同的语法来指定软件包。在软件包组中，
"//foo/bar:__pkg__"和"//foo/bar:__subpackages__"表单分别替换为"//foo/bar"和"//foo/bar/..."。同样，"//visibility:public"和"//visibility:private"只是"public"和"private"。
- 软件包组使用不同的语法来指定软件包。在软件包组中，
例如，如果 //some/package:mytarget 的 visibility 设置为 [":__subpackages__", "//tests:__pkg__"]，则 //some/package/... 源代码树中的任何目标以及 //tests/BUILD 中定义的目标都可以使用它，但 //tests/integration/BUILD 中定义的目标无法使用它。
最佳实践：如需向同一组软件包显示多个目标，请使用 package_group，而不是在每个目标的 visibility 属性中重复列表。这样可以提高可读性，并防止列表不同步。
规则目标公开范围
规则目标的可见性如下：
其
visibility属性的值（如果已设置）；或者目标的
BUILD文件中package语句的default_visibility参数的值（如果存在此类声明）；否则//visibility:private。
最佳实践：避免将 default_visibility 设为公开。这在进行原型设计或在小型代码库中时可能很方便，但随着代码库的增长，无意中创建公共目标的风险也会增加。最好明确说明哪些目标是软件包公共接口的一部分。
示例
文件 //frobber/bin/BUILD：
# This target is visible to everyone
cc_binary(
name = "executable",
visibility = ["//visibility:public"],
deps = [":library"],
)
# This target is visible only to targets declared in the same package
cc_library(
name = "library",
# No visibility -- defaults to private since no
# package(default_visibility = ...) was used.
)
# This target is visible to targets in package //object and //noun
cc_library(
name = "subject",
visibility = [
"//noun:__pkg__",
"//object:__pkg__",
],
)
# See package group "//frobber:friends" (below) for who can
# access this target.
cc_library(
name = "thingy",
visibility = ["//frobber:friends"],
)
文件 //frobber/BUILD：
# This is the package group declaration to which target
# //frobber/bin:thingy refers.
#
# Our friends are packages //frobber, //fribber and any
# subpackage of //fribber.
package_group(
name = "friends",
packages = [
"//fribber/...",
"//frobber",
],
)
生成的文件目标公开范围
生成的文件目标的公开范围与生成它的规则目标相同。
源文件目标公开范围
您可以通过调用 exports_files 来明确设置源文件目标的可见性。如果未向 exports_files 传递任何 visibility 参数，则会将公开范围设为公开。exports_files 不得用于替换生成的文件的公开范围。
对于未出现在对 exports_files 的调用中的源文件目标，可见性取决于标志 --incompatible_no_implicit_file_export 的值：
如果设置了此标志，则公开范围为“私享”。
否则，系统会应用旧版行为：公开范围与
BUILD文件的default_visibility相同，如果未指定默认公开范围，则为私享。
避免依赖旧版行为。每当源文件目标需要非私有可见性时，请务必编写 exports_files 声明。
最佳实践：请尽可能公开规则目标，而不是源文件。例如，请勿对 .java 文件调用 exports_files，而是将该文件封装在非私密 java_library 目标中。一般来说，规则目标应仅直接引用位于同一软件包中的源文件。
示例
文件 //frobber/data/BUILD：
exports_files(["readme.txt"])
文件 //frobber/bin/BUILD：
cc_binary(
name = "my-program",
data = ["//frobber/data:readme.txt"],
)
配置设置的可见性
过去，Bazel 未强制执行在 select() 的键中引用的 config_setting 目标的可见性。有两个标志可用于移除此旧版行为：
--incompatible_enforce_config_setting_visibility用于为这些目标启用可见性检查。为了协助迁移，它还会导致任何未指定visibility的config_setting都被视为公开的（无论软件包级default_visibility如何）。--incompatible_config_setting_private_default_visibility会导致未指定visibility的config_setting遵循软件包的default_visibility，并回退到私有可见性，就像任何其他规则目标一样。如果未设置--incompatible_enforce_config_setting_visibility，则无操作发生。
避免依赖旧版行为。如果软件包尚未指定合适的 default_visibility，则打算在当前软件包之外使用的任何 config_setting 都应具有显式 visibility。
软件包组目标可见性
package_group 目标没有 visibility 属性。这些内容始终对公众公开显示。
隐式依赖项的公开范围
某些规则具有隐式依赖项，即未在 BUILD 文件中明确说明，但与该规则的每个实例固有相关的依赖项。例如，cc_library 规则可能会创建一个隐式依赖项，将其每个规则目标与表示 C++ 编译器的可执行目标相关联。
系统会针对包含定义规则（或方面）的 .bzl 文件的软件包检查此类隐式依赖项的公开范围。在我们的示例中，只要 C++ 编译器与 cc_library 规则的定义位于同一软件包中，就可以是私有的。作为后备，如果定义中未显示隐式依赖项，系统会针对 cc_library 目标进行检查。
您可以通过停用 --incompatible_visibility_private_attributes_at_definition 来更改此行为。停用后，系统会将隐式依赖项视为任何其他依赖项。这意味着，依赖的目标（例如我们的 C++ 编译器）必须对规则的每个实例可见。在实践中，这通常意味着目标必须具有公开可见性。
如果您想将规则的使用限制为特定软件包，请改用加载可见性。
加载可见性
加载可见性用于控制是否可以从其他 BUILD 或 .bzl 文件加载 .bzl 文件。
与目标可见性保护由目标封装的源代码一样，加载可见性可保护由 .bzl 文件封装的构建逻辑。例如，BUILD 文件作者可能希望将一些重复的目标定义提取到 .bzl 文件中的宏中。如果没有加载可见性的保护，他们可能会发现自己的宏被同一工作区中的其他协作者重复使用，因此修改宏会破坏其他团队的 build。
请注意，.bzl 文件可能有也可能没有相应的源文件目标。如果发生这种情况，则无法保证加载可见性与目标可见性一致。也就是说，同一 BUILD 文件或许能够加载 .bzl 文件，但无法在 filegroup 的 srcs 中列出该文件，反之亦然。这有时会导致希望将 .bzl 文件用作源代码的规则出现问题，例如在生成文档或进行测试时。
如需进行原型设计，您可以通过设置 --check_bzl_visibility=false 来停用加载可见性强制执行。与 --check_visibility=false 一样，不应对已提交的代码执行此操作。
从 Bazel 6.0 开始，可见加载情况。
声明加载可见性
如需设置 .bzl 文件的加载可见性，请从文件内调用 visibility() 函数。visibility() 的参数是软件包规范的列表，就像 package_group 的 packages 属性一样。但是，visibility() 不接受负软件包规格。
对 visibility() 的调用必须在每个文件中仅发生一次，且位于顶级（而非函数内），最好紧随 load() 语句之后。
与目标公开范围不同，默认加载公开范围始终为“公开”。不调用 visibility() 的文件始终可从工作区的任意位置加载。最好在任何并非专门用于在软件包之外使用的新 .bzl 文件的顶部添加 visibility("private")。
示例
# //mylib/internal_defs.bzl
# Available to subpackages and to mylib's tests.
visibility(["//mylib/...", "//tests/mylib/..."])
def helper(...):
...
# //mylib/rules.bzl
load(":internal_defs.bzl", "helper")
# Set visibility explicitly, even though public is the default.
# Note the [] can be omitted when there's only one entry.
visibility("public")
myrule = rule(
...
)
# //someclient/BUILD
load("//mylib:rules.bzl", "myrule") # ok
load("//mylib:internal_defs.bzl", "helper") # error
...
加载可见性做法
本部分介绍了管理加载可见性声明的提示。
因式分解公开范围
如果多个 .bzl 文件应具有相同的可见性，则将其软件包规范纳入一个公共列表可能会很有帮助。例如：
# //mylib/internal_defs.bzl
visibility("private")
clients = [
"//foo",
"//bar/baz/...",
...
]
# //mylib/feature_A.bzl
load(":internal_defs.bzl", "clients")
visibility(clients)
...
# //mylib/feature_B.bzl
load(":internal_defs.bzl", "clients")
visibility(clients)
...
这有助于防止各种 .bzl 文件的公开范围之间意外出现偏差。此外，当 clients 列表很大时，这种方式也更易于阅读。
组合公开范围
有时，.bzl 文件可能需要对由多个较小许可名单组成的许可名单可见。这类似于 package_group 如何通过其 includes 属性纳入其他 package_group。
假设您要弃用一个广泛使用的宏。您希望仅向现有用户和您自己团队拥有的软件包显示该资源。您可以这样写：
# //mylib/macros.bzl
load(":internal_defs.bzl", "our_packages")
load("//some_big_client:defs.bzl", "their_remaining_uses)
# List concatenation. Duplicates are fine.
visibility(our_packages + their_remaining_uses)
使用软件包组进行去重
与目标可见度不同，您无法根据 package_group 定义加载可见度。如果您想针对目标可见性和加载可见性重复使用同一许可名单，最好将软件包规范列表移至 .bzl 文件，这样这两种声明都可以引用该列表。基于上文考虑可见性中的示例，您可以编写以下代码：
# //mylib/BUILD
load(":internal_defs", "clients")
package_group(
name = "my_pkg_grp",
packages = clients,
)
只有在列表不包含任何否定软件包规范的情况下，此方法才有效。
保护个别符号
任何名称以下划线开头的 Starlark 符号都无法从其他文件加载。这样可以轻松创建私有符号，但不允许您与一组有限的可信文件共享这些符号。另一方面，您可以通过加载可见性控制其他软件包可以看到您的 .bzl file，但无法阻止加载任何非下划线符号。
幸运的是，您可以将这两项功能结合使用，实现精细控制。
# //mylib/internal_defs.bzl
# Can't be public, because internal_helper shouldn't be exposed to the world.
visibility("private")
# Can't be underscore-prefixed, because this is
# needed by other .bzl files in mylib.
def internal_helper(...):
...
def public_util(...):
...
# //mylib/defs.bzl
load(":internal_defs", "internal_helper", _public_util="public_util")
visibility("public")
# internal_helper, as a loaded symbol, is available for use in this file but
# can't be imported by clients who load this file.
...
# Re-export public_util from this file by assigning it to a global variable.
# We needed to import it under a different name ("_public_util") in order for
# this assignment to be legal.
public_util = _public_util
bzl-visibility Buildifier lint
有一个 Buildifier lint，如果用户从名为 internal 或 private 的目录加载文件，而用户的文件本身不在该目录的父目录下，则会发出警告。此 lint 早于加载可见性功能，在 .bzl 文件声明可见性的工作区中不需要使用。