跳到正文
cccskills
免费在 GitHub 公开中文介绍

Bazel usage

了解如何在 Carbon 项目中通过 Bazelisk 构建、测试和运行程序，包括指定目标、启用 ASan，以及系统依赖变更后重建缓存。

原文查看原文说明

Instructions that **MUST** be followed when using Bazel or Bazelisk to build, test, and debug in the Carbon repository.

carbon-language/carbon-lang星标 33,929(GitHub 33,929 + cccskills 0)

实测评分 未实测

查看安装方法

适用场景

  • 构建 Carbon 代码
  • 运行与修改相关的测试
  • 启动 Bazel 构建的程序
  • 启用 ASan 进行测试

中文介绍

功能

本技能介绍如何在 Carbon 项目中使用 Bazel 构建、测试和运行程序。为统一版本，项目使用 bazelisk，因此应通过它执行命令，而不是直接调用 bazel。文中给出了构建或测试整个项目，以及针对工具链、示例等目标执行操作的命令。还介绍了如何用 bazelisk run 启动构建出的程序、在测试中启用地址消毒器（ASan），以及系统依赖发生变化后重新构建缓存状态。

适用场景

修改 Carbon 代码后，需要通过构建或测试进行验证时，可以使用本技能。不确定该用哪条命令，或更改系统依赖后需要重新构建时也适用。

使用示例

  • “运行与这次工具链修改相关的测试。”
  • “通过 Bazel 启动 Carbon 驱动程序。”
  • “告诉我如何启用 ASan 运行测试。”

注意事项

在 Carbon 项目中应使用 bazelisk。如果尚未安装，可以使用 ./scripts/run_bazelisk.py。资料未说明针对 Jujutsu 的特殊操作步骤。

本介绍由 AI（OpenAI Codex）根据公开的 SKILL.md 撰写。准确的规格请查看下方原文。

文档检查

AI 根据 SKILL.md 的内容检查了需要注意的操作和使用前提。评分只依据实际运行的结果（实测对比）。

安全性发送数据、删除文件、执行命令等是否有说明
A良好说明了构建和测试命令的范围，未要求执行破坏性操作。
安装难易度所需工具和 API 密钥是否少且有说明
B部分不足需要 Bazelisk；未安装时仅说明可用的替代脚本。

不计入评分。 由 AI（OpenAI Codex）于 2026年10月26日 评估。仅供参考，安装前请同时查看原文。

如果您认为评估有误，请申请复核

请写明哪一项有误以及原因。无需登录。我们会对照 SKILL.md 重新评估，并在此处更新结果。

此表单受 reCAPTCHA 保护，适用 Google 的隐私权政策和服务条款。

包含的文件（1）

  • SKILL.md2.8 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

Bazel usage

<!-- Part of the Carbon Language project, under the Apache License v2.0 with LLVM Exceptions. See /LICENSE for license information. SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception -->

This skill documents how best to use Bazel when building, testing, or manipulating the Carbon repository's Bazel in any way.

Bazel wrappers

Carbon uses Bazel for its build system. To ensure consistent versions, the project uses Bazelisk.

[!IMPORTANT] Always use bazelisk whenever you want to run Bazel. Never run bazel directly in the Carbon project. Anything you want to do with bazel can be done with the bazelisk command instead.

  • Bazelisk: Try to use bazelisk in your existing $PATH if available.
    • run_bazelisk.py: If bazelisk isn't available, use ./scripts/run_bazelisk.py to run bazelisk without it being installed.

Essential commands

Building

  • Build all: bazelisk build //...
  • Build toolchain: bazelisk build //toolchain/...
  • Build specific target: bazelisk build //toolchain:carbon

Testing

  • Test all: bazelisk test //...:all
  • Test toolchain: bazelisk test //toolchain/...
  • Test examples: bazelisk test //examples/...

[!TIP] Running all of the tests can be slow, so try to narrowly test the immediately relevant parts of the project first, and only expand coverage as necessary to be confident in the changes.

[!TIP] For specialized instructions on testing and developing the Carbon toolchain, consult these skills:

Running binaries built by Bazel

[!IMPORTANT] Always manually run binaries built by Bazel using the bazelisk run command. Never run the binary directly from bazel-bin/.

You can run the Carbon driver or command line directly via Bazel:

  • bazelisk run //toolchain -- compile --phase=parse toolchain/parse/testdata/basics/empty.carbon

Advanced configurations

AddressSanitizer (ASan)

To enable ASan for local testing:

  • Pass --config=asan: bazelisk test --config=asan //...

Common pitfalls and troubleshooting

bazel clean

Changes to packages installed on your system (like changing LLVM versions or installing libc++) may not be noticed by Bazel.

  • Run bazelisk clean to force cached state to be rebuilt when environment changes occur.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护，适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Accessing GitHub issues

免费有简介

本技能介绍如何使用命令行`gh`只读查看GitHub issue正文和评论，支持通过编号或URL定位，也可指定其他仓库，并说明如何提取大量评论。

  • 查看issue正文和评论
  • 通过URL读取issue
  • 查看其他仓库的issue
carbon-language/carbon-lang3.4万2026年10月26日 更新

Agent tools

免费有简介

本技能为在 Carbon 代码库中工作的 AI 助手规定文件查看、搜索和编辑工具，并说明临时文件的存放与清理规则，以及何时可以编写和运行自定义程序。

  • 按规定工具搜索Carbon文件
  • 为文件编辑选择专用工具
  • 确认临时文件的存放与清理规则
carbon-language/carbon-lang3.4万2026年10月26日 更新

Builtin functions

免费有简介

本技能介绍如何为Carbon编译器添加内置函数，包括类型注册、签名验证、常量求值、运行时LLVM IR生成、Prelude绑定，以及使用最小Prelude编写针对性测试。

  • 注册内置函数
  • 实现常量求值
  • 添加LLVM IR生成
carbon-language/carbon-lang3.4万2026年10月26日 更新

Code style

免费有简介

了解 Carbon 工具链对 Bazel、C++、Carbon、Markdown 和 Python 文件的格式规范，并查看注释、文档、命名、设计及提交说明的写作要求。

  • 整理 Carbon 代码格式
  • 检查注释和文档
  • 确认名称是否符合实际含义
carbon-language/carbon-lang3.4万2026年10月26日 更新

Diagnostics

免费有简介

本技能介绍如何在Carbon工具链中添加或修改错误和警告，包括注册诊断类型、用带类型的参数构造消息、为源码位置添加标签和上下文，以及检查措辞规范和测试覆盖。

  • 添加诊断消息
  • 为源码位置添加标签
  • 统一诊断措辞
carbon-language/carbon-lang3.4万2026年10月26日 更新

GitHub CLI usage

免费有简介

使用 `gh` 只读搜索和查看 GitHub 的议题、拉取请求、仓库与代码，并了解如何查询 REST 和 GraphQL API、翻页获取结果及筛选或整理输出。

  • 查看议题内容和状态
  • 检查拉取请求差异与检查状态
  • 搜索 GitHub 代码或仓库
carbon-language/carbon-lang3.4万2026年10月26日 更新

查看 carbon-language 的全部技能

报告此技能的问题