shaderc编译失败主因是库链接不全或GLSL源码错误；需正确链接shaderc及其依赖库，检查#version声明、include路径及SPIR-V字节序，复用Compiler实例并读取GetErrorMessage定位问题。
shaderc库编译失败：找不到shaderc::Compiler或链接报错
常见现象是 CMake 找不到 shaderc，或者链接时提示 undefined reference 到 shaderc_compile_into_spv 等符号。根本原因不是 shaderc 没装，而是没正确链接它的动态/静态库，且容易忽略其依赖的 spirv-tools 和 glslang 底层库。
- 用 vcpkg 安装最省事：
vcpkg install shaderc:x64-windows（Windows）或vcpkg install shaderc:x64-linux，然后在 CMake 中通过find_package(shaderc CONFIG)引入 - 手动编译时，必须打开
SHADERC_ENABLE_INSTALL且关闭SHADERC_SKIP_INSTALL，否则make install不会导出头文件和 pkg-config 文件 - 链接顺序很重要：你的目标要先链
shaderc，再链shaderc_shared（如果用了 shared 版本），最后补上spirv-tools-opt和glslang-default-resource-limits—— 少一个就可能 undefined symbol
调用shaderc::Compiler::CompileGlslToSpv返回空shaderc::SpvCompilationResult
不是代码写错了，大概率是 GLSL 源码里有预处理器错误、版本声明缺失，或者 #include 路径没配对。shaderc 默认不展开本地 include，也不会自动加 #version，出错时 result.success() 为 false，但很多人只看返回值没读 result.GetErrorMessage()。
- 务必检查 GLSL 字符串开头有没有合法
#version行，比如#version 450；OpenGL ES 需要#version 310 es，不匹配直接失败 - 如果用了
#include "xxx.glsl"，得自己实现shaderc::CompileOptions::SetIncludeCallbacks，传入能根据requested_source返回内容和source_name的回调函数 - 编译选项别乱开：调试时加
options.SetGenerateDebugInfo()没问题，但上线前关掉，否则 SPIR-V 体积翻倍且含路径信息，可能被逆向
生成的 SPIR-V 在 Vulkan 里vkCreateShaderModule失败，报VUID-VkShaderModuleCreateInfo-pCode-01379
这个验证层错误意思是 SPIR-V 二进制格式非法，90% 是字节序或长度不对。shaderc 输出的是 std::vector<uint32_t></uint32_t>，而 Vulkan 要求传给 vkCreateShaderModule 的是 const uint32_t* + codeSize（单位是 byte，不是 uint32_t 个数）。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 错误写法：
createInfo.codeSize = spv.size()→ 实际传了元素个数，不是字节数 - 正确写法：
createInfo.codeSize = spv.size() * sizeof(uint32_t)，且createInfo.pCode = spv.data() - 别用
std::string存 SPIR-V：GLSL 编译结果是 32 位整数序列，用std::string会导致高位字节被截断或解释成控制字符，std::vector<uint32_t></uint32_t>是唯一安全容器
跨平台运行时编译性能差，每次加载 shader 都卡顿
shaderc 编译本身不慢，但默认行为会做完整语法检查 + 优化 + 验证，而且每次调用都重新解析预处理器。真正拖慢的是没复用 shaderc::Compiler 实例和没预编译内置宏。
立即学习“C++免费学习笔记（深入）”；
-
shaderc::Compiler是线程安全的，全局单例即可，不要每次编译 new 一个 - 用
options.AddMacroDefinition("DEBUG", "1")替代在 GLSL 里写#define DEBUG 1，避免字符串拼接引入语法风险 - 如果 shader 变体多（如带/不带雾效），优先在构建期用 CMake + shaderc 命令行预编译成不同 .spv 文件，运行时只 load，不 compile
实际项目里最容易被跳过的，是验证层报错后直接忽略 result.GetErrorMessage() —— 它通常比 Vulkan validation message 更早、更准指出哪一行 GLSL 出了问题。
