用Python写编译脚本：SCons新手完全指南

Makefile的缩进陷阱、跨平台兼容 nightmare——如果你受够了这些，SCons 是个值得了解的替代方案。它用纯 Python 脚本取代 Make、autoconf 和 automake，一套配置跑通 Linux、macOS 和 Windows。

这份指南从零开始：安装 SCons，搭建多文件 C++ 项目（含静态库），配置嵌入式交叉编译（高通 QuRT 实时操作系统），并拆解 SCons 与 Make、CMake 的核心差异。所有示例代码可独立运行，每步都能看到真实输出。

SCons 是什么，为何存在

SCons 是 2001 年 Steven Knight 用纯 Python 编写的开源跨平台构建工具。其前身"ScCons"在 2000 年 8 月的 Software Carpentry SC Build 竞赛中胜出，后更名为 SCons。Knight 的设计大量借鉴了 Bob Sidebotham 1990 年代末开发的 Perl 构建工具 Cons——后者引入了当时激进的理念：基于 MD5 哈希的内容变更检测（而非时间戳）、自动依赖扫描等。

与 Make、CMake、Meson 的对比

Make 依赖制表符缩进和 shell 命令，跨平台时需大量条件判断；CMake 用领域特定语言生成平台原生构建文件；Meson 追求简洁但语法独立。SCons 的独特之处在于：构建文件就是 Python 脚本，可直接调用 Python 生态的任意库，且内置跨平台抽象层。

三个核心环境

SCons 区分三种环境对象：外部环境（os.environ 的副本）、构建环境（Construction Environment，编译/链接变量的容器）、执行环境（命令运行的 shell 环境）。理解这一分层是编写复杂构建逻辑的前提。

从首份 SConstruct 到增量构建

最小可运行的 SConstruct 仅需一行：Program('hello.c')。多文件项目中，SCons 自动扫描 #include 依赖，仅重建变更内容。通过 --debug=tree 可可视化依赖图，排查"为何重新编译了整个项目"的困惑。

交叉编译实战：高通 QuRT

同一 SConstruct 可同时输出 x86 原生二进制和 Hexagon DSP 的 QuRT 可执行文件。关键是通过 Clone() 创建独立环境实例，分别设置 CC、CXX、LINK 等 Construction Variables，再用 VariantDir 隔离构建产物目录。

进阶：自定义扫描器与共享缓存

非标准文件类型（如自定义 DSL）可通过 Scanner 对象接入依赖检测。团队场景下，启用 Shared Build Cache 可将编译产物分发至共享存储，避免重复构建相同对象文件。配合 AddOption 添加命令行开关，可灵活切换调试/发布模式、指定目标平台等。

需要 Python 3.7+ 和 C++ 编译器（GCC/Clang/MSVC）。QuRT 章节需安装 Qualcomm Hexagon SDK，但可跳过不影响主体内容。无构建系统经验亦可跟随，有 Make 背景则能更快体会设计差异。