WPF发布后未引用DLL文件，调试与生成阶段正常该如何解决？

1. 排查DLL打包规则配置 #

调试阶段能正常调用、部署后无法找到DLL的核心原因通常是DLL未被识别为项目依赖项，没有被打包到最终部署包中，可按以下步骤修复：

• 找到项目中对应DLL的引用项，右键点击选择「属性」，确认复制到输出目录选项设置为如果较新则复制或始终复制，不要选择不复制。
• 如果你是通过Assembly.LoadFrom等API动态加载DLL而非显式添加项目引用，VS默认不会识别该依赖，需要右键项目→「添加」→「现有项」，手动将两个DLL导入到项目中，再按上述步骤设置复制到输出目录的属性。
• 如果你使用ClickOnce部署，还需要进入右键项目→「属性」→「发布」→「应用程序文件」，找到两个DLL对应的条目，将发布状态设置为包含，避免被自动排除。

2. 解决添加引用报错问题 #

手动添加DLL引用报错通常由框架兼容性或架构不匹配导致，可按以下路径排查：

• 框架不兼容：确认DLL的目标运行时和WPF项目的目标框架匹配。如果是.NET Framework生成的DLL需要在.NET Core/.NET 5+项目中引用，可以直接编辑项目.csproj文件，在<PropertyGroup>节点中添加配置：

  <AssetTargetFallback>net48</AssetTargetFallback>
  

  其中net48替换为DLL对应的.NET Framework版本即可。
• 架构不匹配：因为你有x86、x64两个版本的DLL，不要设置项目平台目标为Any CPU，建议使用条件引用自动适配不同架构，编辑.csproj文件添加如下规则：

  <Choose>
    <When Condition="'$(Platform)' == 'x86'">
      <Reference Include="你的DLL文件名">
        <HintPath>..\Lib\x86\你的DLL文件名.dll</HintPath>
      </Reference>
    </When>
    <When Condition="'$(Platform)' == 'x64'">
      <Reference Include="你的DLL文件名">
        <HintPath>..\Lib\x64\你的DLL文件名.dll</HintPath>
      </Reference>
    </When>
  </Choose>
  

  将路径替换为你本地存放两个版本DLL的实际路径即可，后续编译不同架构版本时会自动引用对应DLL。

3. 部署校验 #

打包完成后先打开部署输出目录，确认两个DLL文件存在于程序根目录或你代码中指定的加载路径下，再运行程序验证调用逻辑。

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