D3DCompile 返回 E_INVALIDARG 最常见原因是源码指针为 nullptr 或长度为 0；需确保 pSrcData 指向有效内存、SrcDataSize 精确匹配字节数，入口名与目标模型（如 "ps_5_0"）严格一致，且路径、包含处理、错误缓冲区生命周期等均正确。
编译 HLSL 时 D3DCompile 返回 E_INVALIDARG
最常见原因是传入的源码指针为 nullptr，或 srcData 长度为 0。DirectX SDK 的 D3DCompile 不做空指针防护，直接崩溃或返回无效参数错误。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用
std::filesystem::read_bytes（C++17）或CreateFileMapping+MapViewOfFile读取 .hlsl 文件，确保pSrcData指向有效内存，且SrcDataSizeInBytes精确匹配字节数（不含额外 - 不要用
std::string::c_str()直接传给D3DCompile——如果字符串含嵌入 - 检查
szEntryPoint和szTarget：入口名必须与 HLSL 文件中float4 main(...) {...}完全一致（区分大小写）；szTarget如"vs_5_0"、"ps_5_1"必须与设备支持的着色器模型匹配，错写成"vs_6_0"也会触发E_INVALIDARG
用 D3DCompileFromFile 编译却提示文件未找到
D3DCompileFromFile 内部调用的是 Windows API 的文件 I/O，不走 C++ 标准库路径解析逻辑，对相对路径处理很“直白”：它以当前工作目录（not VS 项目目录，not .exe 所在目录）为基准查找文件。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 调试前先用
GetFullPathName打印你要加载的路径，确认是否真能定位到 .hlsl 文件 - 避免依赖相对路径：用
GetModuleFileName获取 exe 路径，再拼出L"shaders\lighting.hlsl" - 若需包含其他 .hlsl（如
#include "common.h"），必须显式传入ID3DInclude实现——默认nullptr会导致包含失败，错误信息是D3DERR_INVALIDCALL或静默失败
编译成功但运行时报 E_FAIL 或黑屏
这往往不是编译问题，而是着色器字节码未被正确创建为 ID3D11VertexShader 或 ID3D11PixelShader 对象。常见于忽略 ppErrorMsgs 输出，或没检查 ppCode 是否非空。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 永远检查
hr返回值，并在失败时用OutputDebugStringA打印ppErrorMsgs->GetBufferPointer()内容——HLSL 语法错、语义冲突（如TEXCOORD0输入和输出不匹配）、寄存器溢出都会在这里报具体行号 -
ppCode是编译后的字节码，必须完整传递给ID3D11Device::CreateVertexShader，不能只传前 N 字节；注意ppCode->GetBufferSize()才是真实大小 - Debug 版本务必开启
D3DCOMPILE_DEBUG | D3DCOMPILE_ENABLE_STRICTNESS，否则某些隐式类型转换（如int赋给float4）会在 Release 下静默失败
C++20 / MSVC 项目里链接 d3dcompiler.lib 报 LNK2019
VS 默认不链接 d3dcompiler.lib，且该库在 Windows SDK 中按架构拆分（x64/x86/arm64），容易配错。LNK2019 表明链接器找不到 D3DCompile 符号，而非运行时报错。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 在项目属性 → 链接器 → 输入 → 附加依赖项中，明确添加
d3dcompiler.lib（不是d3d11.lib） - 确认 Windows SDK 版本 ≥ 10.0.18362.0（对应 VS 2019 16.3+），旧 SDK 可能缺少
D3DCompile2等新函数声明 - 若用静态链接（
/MT），确保d3dcompiler.lib也是静态版；动态运行时（/MD）则需部署D3DCompiler_47.dll到目标机器（Win10 自带，Win7 需单独分发）
ID3DBlob* 声明为局部变量，又在函数返回后才去读 ppErrorMsgs->GetBufferPointer()，此时内存可能已被释放，看到的是乱码或崩溃。务必在 D3DCompile 返回后立刻消费错误信息，或用智能指针管理 ID3DBlob 生命周期。 
