使用清单加载子目录中C++ DLL的问题排查

嘿，我之前也踩过清单加载DLL的坑，你的问题其实出在清单路径的写法上，而且原生C++完全可以用清单实现这个需求，咱们一步步说：

为什么你的清单没用？ #

你在清单里写的<file name="sdk\LoadDll.dll">是错误的——Windows加载器处理清单里的file元素时，不会识别路径分隔符，它会把sdk\LoadDll.dll当作一个完整的文件名，而不是“sdk子目录下的LoadDll.dll”。这就导致加载器去当前工作目录找一个叫sdk\LoadDll.dll的文件，自然找不到，所以报错。

原生C++怎么用清单加载子目录DLL？ #

正确的做法是用**probing元素**来指定DLL的搜索子目录，而不是在file里写路径。给你两种可行的清单写法：

写法一：结合依赖项声明（更规范）

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <dependency>
    <dependentAssembly>
      <!-- 这里的name和version要和你的应用程序匹配，或者自定义一个标识 -->
      <assemblyIdentity 
        type="win32" 
        name="LoadApp" 
        version="1.0.0.0" 
        processorArchitecture="x86"/>
      <!-- 声明你要加载的DLL文件名 -->
      <file name="LoadDll.dll"/>
      <!-- 关键：告诉加载器去sdk子目录找这个DLL -->
      <probing privatePath="sdk"/>
    </dependentAssembly>
  </dependency>
</assembly>

写法二：直接添加probing元素（更简洁）

如果不需要严格的依赖项标识，也可以直接在清单根节点下加probing，这样加载器会自动去指定的子目录找所有依赖DLL：

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <!-- 可以指定多个子目录，用分号分隔，比如sdk;plugins -->
  <probing privatePath="sdk"/>
</assembly>

额外注意事项 #

• 确保清单已经正确嵌入到LoadApp.exe里：在Visual Studio项目属性的「清单工具」→「输入和输出」里，把「嵌入清单」设为「是」，或者用mt.exe工具手动嵌入（命令比如mt.exe -manifest sdk.manifest -outputresource:LoadApp.exe;1）
• 如果LoadDll.dll还有自己的依赖DLL，这些DLL也要放在sdk目录里，或者能被加载器找到的路径中
• privatePath只能指定应用程序目录下的子目录，不能用绝对路径或者上级目录

这样调整后，你的LoadApp.exe运行时应该就能找到sdk目录下的LoadDll.dll了。

内容的提问来源于stack exchange，提问作者ldlchina