GN 概述

GN是 Google 开发的 元建立程序用于快速生成高效、正确的 Ninja 建立文件。它本身不直接编译代码，而是将项目配置转化为高度调整的 build.ninja随后由 Ninja 负责真正的编译与链接。

主要特点

• 速度较快数秒内完成数十万个目标的依赖解析与文件生成。
• 声明式语法类似 Python 的缩进敏感语法。强调“描述建立什么”，避免隐式规则导致错误。
• 可重现性相同输入总生成相同输出，保证 CI 与团队协作一致性。
• 跨网站抽象原生支持 OS 与 CPU 检测，使跨网站规则更直观。
• 工具链建模清晰工具链被视为一等公民，方便主机/目标/交叉编译场景。

设计哲学

1. 正确性高于灵活性
2. Simplicity over completeness

   历史背景与定位

   Ninja 是高速并行执行引擎，而 GN 则是专注于为它生成最优输入。相比 Bazel 等全功能建立程序，GN 更轻量、更专注于 C++/Ninja 技术栈。是 Chromium、Fuchsia 等主要项目的官方建立程序。不过，

   主要概念解析

   目标

   A target 是建立中的基本单元。可以是可执行文件、库或自定义动作。从常见类型来看，

   动作的观点是。运行自定义脚本或命令来生成文件 --- action { script = "gen.py" outputs = } -->

   A target can have many attributes:

   • `sources` – list of source files.
   • `deps` – direct dependencies.
   • `configs` – compile configurations applied only to this target.
   • `public_configs` – propagate configs to dependents.
   `
   • `visibility` – restrict which or targets can depend on it.`

     *痛点*这方面，在大型项目中管理数千个 target 时容易出现遗漏或重复定义，导致依赖图错误或编译时间膨胀。 使用 `group` 或 `source_set` 能显著减少重复编译，但需要熟悉其作用域和传播规则。

     依赖关系

     • `deps`这方面。必须在当前目标之前建立，并提供链接所需对象或库。*痛点*这方面，未声明 deps 导致 “undefined reference” 错误；按理说，过多私有 deps 增加建立时间。怎么说呢，
     • `public_deps`: 同时传递依赖及其 public_configs 给后继者 *痛点*这方面。忘记使用 public_deps 时导致头文件找不到，引发大量 #include 错误。
     • `data_deps`: 在运行时需要但不影响链接。例如资源文件 *痛点*这方面，数据文件未同步更新会导致运行时崩溃，需要手动维护拷贝方法。

     配置

     A config bundles compiler flags,defines,include paths etc.。and can be attached via `configs` or `public_configs`. It is a powerful way to maintain consistent build options across many targets.

     • 说到*痛点*，多层 config 覆盖顺序易混淆；忘记 public_configs 会让下游缺少必要头方法或宏定义。
     • 再看*Tip*，Use `forward_variables_from` in templates to propagate config vars automatically.

     A toolchain defines compiler/linker commands used for a specific platform or architecture. In GN you declare m once and refer by tag . The current toolchain is available as `current_toolchain`。enabling conditional logic per platform.

     • 说到*痛点*，当多个工具链共存时一不小心会在错误的 toolchain 上构造 target，导致不可预期的网站差异。

   类型	声明函数	用途
   可执行文件	executable	独立程序
   静态库	static_library	归档库
   共享库	shared_library	动态链接库
   源文件集  source_set
   组  –> 不产生输出，只聚合依赖  — 用于入口目标如 //:all