Visual Studio 2022未本地复制DLL触发FileNotFoundException求助

1. 配置程序集加载路径 #

• 检查系统环境变量PATH是否包含DLL所在的集成目录，若未添加则补充后重启Visual Studio及项目进程。
• 若基于.NET Framework开发，可在项目的app.config/web.config中添加程序集探测配置：

<runtime>
  <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    <probing privatePath="集成目录相对路径或绝对路径"/>
  </assemblyBinding>
</runtime>

注意：绝对路径需保证所有开发/部署环境一致，相对路径以项目输出目录为基准。

2. 排查DLL依赖项 #

• 打开VS开发者命令提示符，执行dumpbin /dependents "DLL文件完整路径"，查看该DLL是否依赖其他未在集成目录或系统路径中的组件，若有缺失需将对应依赖DLL移入集成目录或添加到PATH。
• 用Dependency Walker工具扫描DLL，排查隐藏的依赖缺失问题（注意匹配对应.NET版本）。

3. 核对程序集版本一致性 #

• 在Visual Studio中右键引用的DLL，查看属性里的版本号，对比集成目录中DLL的实际版本（右键DLL→属性→详细信息→文件版本/产品版本），若版本不匹配需更新引用指向正确版本，或同步集成目录DLL版本。
• 确认DLL是否意外启用强命名（虽你这里PublicKeyToken为null，但仍需排查），保证版本、公钥令牌完全一致，避免强命名验证失败导致加载异常。

4. 清理缓存与全局程序集 #

• 手动删除项目bin/Debug/bin/Release输出目录下的所有文件，重新构建项目。
• 执行gacutil /l My.Extensions.IO检查该DLL是否被安装到全局程序集缓存（GAC），若存在则用gacutil /u My.Extensions.IO卸载，避免加载GAC中的旧版本引发冲突。

5. 调试程序集加载过程 #

• 在Visual Studio中开启程序集加载日志：工具→选项→调试→输出窗口，勾选所有“程序集加载”相关选项，运行项目后查看输出窗口中My.Extensions.IO的加载日志，明确失败原因。
• 使用fuslogvw.exe（程序集绑定日志查看器）启用日志记录，运行项目后查看详细绑定失败日志，定位问题根源。

6. 匹配项目与DLL的平台目标 #

• 确认项目的平台目标（x86/x64/Any CPU）与DLL编译平台一致：项目属性→生成→平台目标，调整为与DLL相同的平台，避免因架构不兼容无法加载。
• 检查配置管理器中项目的构建平台，确保与DLL平台匹配。

7. 验证集成目录的访问权限 #

• 确认运行Visual Studio的用户对集成目录有读取权限，避免因权限不足无法读取DLL。
• 若集成目录是网络共享目录，检查网络连接及共享权限是否正常，可临时将DLL复制到本地目录测试，排除网络访问问题。

内容的提问来源于stack exchange，提问作者A. Drews