build2 初始化失败主因是未将bdep等可执行文件路径加入PATH；依赖需在manifest声明版本、在buildfile引入target；第三方库需bdep update同步；C++标准用cxx.std设，编译选项用cxx.coptions。
build2 项目初始化失败：没有 bdep init 或 build2 命令
根本原因是 build2 不是传统意义上的“安装即用”工具链，它由多个独立可执行文件组成（bdep、bpkg、build2），且不进系统 PATH。你运行 bdep init 报错“command not found”，大概率是只下载了源码或二进制包但没把对应目录加进环境变量。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 从 build2 官网下载页 拿预编译包（推荐 Linux/macOS 的
tar.xz或 Windows 的.zip），解压后进入bin/目录确认存在bdep、bpkg、build2三个可执行文件 - 把
bin/路径加入$PATH（Linux/macOS 加到~/.bashrc或~/.zshrc；Windows 加到系统环境变量） - 验证：终端运行
bdep --version和bpkg --version，两者都应输出版本号，缺一不可 - 别用包管理器装（如 apt/yum/Homebrew），它们提供的往往是过时或阉割版，尤其 macOS 上 Homebrew 的
build2包缺失bdep
依赖声明写在 manifest 还是 buildfile？
初学者容易混淆这两类文件的职责：manifest 描述包元信息（名字、版本、作者、依赖列表），用于发布和解析；buildfile 是构建逻辑，负责实际链接、编译、生成规则。依赖必须同时出现在两个地方，但目的不同。
实操建议：
立即学习“C++免费学习笔记（深入）”；
-
manifest中用depends: libhello ^1.2.0声明语义化版本约束，这是bpkg解析依赖图的唯一依据 -
buildfile中用using hello: libhello%lib{hello}引入已解析的依赖，并指定使用其lib{hello}target —— 这步漏掉，编译时会报undefined reference - 如果依赖是头文件库（如
fmt），buildfile里只需using fmt: fmt%lib{fmt}，但链接时不加-lfmt，因为头文件库不产生链接符号 - 不要在
buildfile里写版本号，版本只管在manifest里管；buildfile只认bpkg解析后分配的 target 名
第三方库找不到：bpkg install 成功但 build2 编译报 unknown target 'lib{xxx}'
这说明 bpkg 已把库下载并注册进本地仓库，但当前项目没启用该仓库，或者依赖未被正确“拉取”进项目上下文。build2 的依赖不是全局生效的，每个项目需显式同步。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 确保项目根目录有
repositories.manifest，内容至少包含一行：repository: https://pkg.cppget.org/1/stable（官方稳定源） - 运行
bpkg install libhello后，必须紧接着运行bdep update—— 它会读取manifest中的depends:，调用bpkg解析依赖树，并把结果写入build-root/下的root.build和repositories/ - 检查
build-root/repositories/是否有对应库的 symlink；没有就说明bdep update没跑成功或manifest依赖名拼错 - 避免手动改
build-root/下的文件，所有操作走bdep和bpkg命令，否则状态易不一致
C++ 标准与编译器选项怎么设？cxx.std 和 cxx.poptions 到底谁管什么
cxx.std 控制语言标准（如 c++17），影响语法解析和内置宏定义；cxx.poptions 是预处理器选项（如 -I、-D），而 cxx.coptions 是编译器选项（如 -O2、-Wall）。三者作用域不同，混用会导致行为不符合预期。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 语言标准统一在
buildfile顶层设：project = hello: 1.0.0; cxx.std = 17;，不要在每个exe或librule 里重复设 - 头文件搜索路径用
cxx.poptions += "-I" "path/to/include"，注意+=是追加，=是覆盖；第三方库的 include 路径由using xxx自动注入，无需手动加 - 警告和优化选项写在
buildfile的if ($c.target.class == "gcc") { cxx.coptions += "-Wall -Wextra" }这类条件块里，避免 clang/gcc 选项冲突 - 修改任何
cxx.*配置后，必须删掉build-root/并重新跑build2，因为 build2 默认缓存配置，不自动重载
build2 的“项目即仓库”模型意味着每一步操作都强耦合于命令顺序和文件状态，跳过 bdep update 或手改 build-root 是最常被忽略的断点。
