本页简要介绍了 Bazel 中使用的语言 Starlark（以前称为 Skylark）。如需查看函数和类型的完整列表，请参阅 Bazel API 参考文档。
如需详细了解该语言，请参阅 Starlark 的 GitHub 代码库。
如需查看 Starlark 语法和行为的权威规范，请参阅 Starlark 语言规范。
语法
Starlark 的语法受 Python3 启发。以下是 Starlark 中的有效语法：
def fizz_buzz(n):
"""Print Fizz Buzz numbers from 1 to n."""
for i in range(1, n + 1):
s = ""
if i % 3 == 0:
s += "Fizz"
if i % 5 == 0:
s += "Buzz"
print(s if s else i)
fizz_buzz(20)
Starlark 的语义可能与 Python 不同，但行为差异很少，除非 Starlark 引发错误。支持以下 Python 类型：
类型注解
实验性。类型注解是一项实验性功能，可能会随时发生变化。请勿依赖此分析。您可以在 Bazel 的 HEAD 中使用 --experimental_starlark_types 标志启用此功能。
Bazel 的 HEAD 中的 Starlark 正在逐步添加对类型注解的支持，其语法受 PEP 484 启发。
- Starlark 类型注解正在积极开发中。进度可通过问题 22935 进行跟踪。
- 该规范会逐步扩展：starlark-with-types/spec.md
- 初始提案：SEP-001 引导 Starlark 类型
可变性
Starlark 支持不可变性。可用的可变数据结构有两种：列表和字典。对可变数据结构的更改（例如，将值附加到列表或删除字典中的条目）仅对在当前上下文中创建的对象有效。上下文完成后，其值将变为不可变。
这是因为 Bazel build 使用并行执行。在构建期间，每个 .bzl 文件和每个 BUILD 文件都会获得自己的执行上下文。系统还会在其自身上下文中分析每条规则。
我们来看一个使用 foo.bzl 文件的示例：
# `foo.bzl`
var = [] # declare a list
def fct(): # declare a function
var.append(5) # append a value to the list
fct() # execute the fct function
Bazel 会在 foo.bzl 加载时创建 var。因此，var 是 foo.bzl 上下文的一部分。fct() 运行时，是在 foo.bzl 的上下文中运行的。foo.bzl 的求值完成后，环境中会包含一个值为 [5] 的不可变条目 var。
当另一个 bar.bzl 从 foo.bzl 加载符号时，加载的值将保持不变。因此，bar.bzl 中的以下代码是非法的：
# `bar.bzl`
load(":foo.bzl", "var", "fct") # loads `var`, and `fct` from `./foo.bzl`
var.append(6) # runtime error, the list stored in var is frozen
fct() # runtime error, fct() attempts to modify a frozen list
在 bzl 文件中定义的全局变量无法在定义它们的 bzl 文件之外更改。与上述使用 bzl 文件的示例一样，规则返回的值是不可变的。
BUILD 文件与 .bzl 文件之间的差异
BUILD 文件通过调用规则来注册目标。.bzl 文件用于提供常量、规则、宏和函数的定义。
原生函数和原生规则是 BUILD 文件中的全局符号。bzl 文件需要使用 native 模块加载它们。
BUILD 文件中存在两项语法限制：1) 声明函数是非法的，2) 不允许使用 *args 和 **kwargs 参数。
与 Python 的区别
全局变量是不可变的。
不允许在顶级使用
for语句。请改为在函数中使用它们。在BUILD文件中，您可以使用列表推理。不允许在顶级使用
if语句。不过，可以使用if表达式：first = data[0] if len(data) > 0 else None。迭代字典的确定性顺序。
不允许递归。
Int 类型仅限于 32 位有符号整数。溢出将会抛出错误。
在迭代期间修改集合是错误的。
除了等式测试之外，比较运算符
<、<=、>=、>等未跨值类型定义。简而言之：5 < 'foo'会抛出错误，5 == "5"会返回 false。在元组中，只有当元组位于圆括号中（即您写的是
(1,)而非1,）时，尾随英文逗号才有效。字典字面量不得包含重复的键。例如，以下是错误：
{"a": 4, "b": 7, "a": 1}。字符串使用双引号表示（例如，调用 repr 时）。
字符串不可迭代。
不支持以下 Python 功能：