distcc集群必须先跑通单机预编译流程，因distcc仅转发-c阶段，本地需能独立完成gcc -E生成正确.i文件；DISTCC_HOSTS须显式指定远端编译器路径与版本，且所有节点头文件树必须完全一致。
distcc 集群必须先跑通单机预编译流程
直接上 distcc 很容易卡在 distccd 启动后无响应或编译器找不到头文件。根本原因是 distcc 不做预处理，只转发 -c 阶段（即从 .i 到 .o），所以本地机器必须能独立完成预处理（gcc -E）并生成正确的 .i 文件——这意味着你本地的 gcc、g++、头文件路径、-I 参数、宏定义都得先验证能跑通单机编译。
实操建议：
- 先用
make -j1 CC="gcc -save-temps" CXX="g++ -save-temps"编一个源文件，确认生成了xxx.i和xxx.s，且xxx.i内容可读（没报错、没乱码） - 检查所有
-I路径是否为绝对路径，或确保所有节点共享相同的目录结构（比如都挂载在/opt/sdk） - 避免使用
-fPIE、-fstack-protector-strong等可能触发本地预处理异常的 flag，先精简到最小可行集再逐步加回
DISTCC_HOSTS 环境变量不能只写 IP，要带编译器标识
DISTCC_HOSTS="192.168.1.10 192.168.1.11" 这种写法看似合理，但实际会失败：distcc 默认尝试调用远端的 gcc，而你的 worker 节点可能装的是 gcc-12 或 clang++，版本不一致直接导致 cc1plus: error: unrecognized command line option。
正确写法必须显式声明远端编译器路径和版本：
立即学习“C++免费学习笔记（深入）”；
-
DISTCC_HOSTS="192.168.1.10/4,gcc-12 192.168.1.11/4,clang++-15"——/4表示该节点最多接受 4 个并发任务 - 所有节点的
distccd必须用--allow显式放行客户端网段，例如：distccd --allow 192.168.1.0/24 --log-file /var/log/distccd.log - worker 节点上运行
which gcc-12和gcc-12 --version，确保路径与DISTCC_HOSTS中写的完全一致（包括软链接目标）
和 ccache 组合时，顺序错了就等于白配
很多人把 export CC="ccache gcc" 和 export DISTCC_HOSTS=... 一起设，结果发现 distcc 根本没走——因为 ccache 在哈希计算时默认忽略 DISTCC_HOSTS，它只认编译器命令字面量。一旦 ccache 命中缓存，就直接返回 .o，根本不会触发 distcc 分发。
解决办法只有两种，选其一：
- 禁用 ccache 对 distcc 流程的干扰：
export CC="distcc gcc"，然后在 worker 节点各自配好ccache（这样每个 worker 编译时自己用 ccache，主节点不参与缓存决策） - 强制 ccache 将 distcc 视为不同编译器：
export CC="ccache distcc gcc"，但需提前运行ccache -o compiler_check=content，否则 ccache 仍按gcc的二进制签名去查缓存 - 更稳妥的做法：CI 流水线里分两阶段——首次全量构建用纯 distcc；后续增量构建关掉 distcc，只开 ccache
IncrediBuild 在 Windows 上要防住 MSVC 工具链路径漂移
IncrediBuild 的 BuildConsole 默认依赖 VS Installer 注册表项找 cl.exe，但如果你用的是 Visual Studio Build Tools、或者手动解压的 VC++ 工具链（如 v143）、甚至 WSL2 中的交叉工具链，注册表路径很可能为空或指向旧版本。
关键动作不是改环境变量，而是重写配置文件：
- 编辑
%ProgramFiles(x86)%\Incredibuild\BuildConsole.exe.config，在<configuration>下添加：<appSettings> <add key="VCInstallDir" value="C:\Program Files\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.38.33130\"/> </appSettings>
- 确认
cl.exe所在目录已加入PATH，且vcvarsall.bat能正常执行（IncrediBuild 内部会调用它初始化环境） - 禁止勾选 “Use local machine for build” —— 即使只配了本机 agent，也要把它当成远程节点对待，否则部分模板元编程代码会因环境变量缺失而编译失败
最常被跳过的一步是验证预处理一致性：distcc 不同步 .h 文件内容，所有节点必须有完全相同的头文件树。哪怕一个 #define 多空格，都可能导致 xxx.i 哈希不同，进而让 distcc 拒绝复用远端结果，退化成单机编译。
