下载Visual Studio Online项目到其他PC时缺失DLL的正确处理方法
导入的开源类库跨设备编译缺失Entity Framework相关DLL的处理方案
场景说明
- 从GitHub下载JsonUtils开源项目,项目托管地址为https://github.com/bladefist/JsonUtils ,原解决方案根目录包含
Website、Classlibrary、Packages三个文件夹,其中类库模块包含需要复用的全部功能。 - 第一台开发PC上直接编译原开源解决方案可正常运行;后续将其中的类库文件复制到自有解决方案中,通过「添加现有项目」功能导入,导入后项目状态正常,对应项目结构截图地址为https://i.sstatic.net/gFJsK.png ,可正常调用类库方法并获得预期结果。
- 自有解决方案整体签入Azure DevOps(VSO)后,在另一台PC上拉取项目代码编译时,出现引用缺失错误,对应缺失引用报错截图地址为https://i.sstatic.net/zicAX.png ,提示找不到
System.Data.Entity.Design.PluralizationServices.dll。 - 回到初始可正常运行的PC上,开启「显示所有文件」选项后,可在类库项目的
bin输出目录下找到该缺失DLL,对应bin目录内容截图地址为https://i.sstatic.net/eFnIB.png ;对比发现新PC拉取的项目中,不存在原开源方案根目录下用于存放依赖的Packages文件夹。
问题本质
- 日常做源代码管理时,默认都会把NuGet生成的
Packages文件夹排除在提交范围外,这个文件夹本质是本地依赖的缓存目录,换设备拉代码时看不到它是完全正常的,不是代码丢失。 - 报错缺失的
System.Data.Entity.Design.PluralizationServices.dll是Entity Framework 6自带的附属工具DLL,不是Windows系统或者.NET Framework默认预装的组件。第一台PC能正常编译,纯粹是因为之前在这台机器上跑过NuGet还原,把这个DLL缓存到本地了,换了没还原过依赖的新机器,自然找不到文件。
正确处理步骤
- 先检查类库项目对应的
packages.config有没有完整提交到源代码管理,这个文件里会记录项目依赖的Entity Framework的具体版本,是NuGet还原的核心依据。 - 在新PC上用Visual Studio打开解决方案,直接右键顶层解决方案节点,选择「还原NuGet包」,等系统自动把所有需要的依赖下载到本地,生成对应的
Packages文件夹。 - 翻一下类库项目里对这个缺失DLL的引用属性,把「复制本地」的选项改成
False——如果开了复制本地,之前编译的时候这个DLL会被自动放到项目的bin目录,误把这些临时编译文件提交到代码库属于不规范操作。 - 等NuGet包还原完成,重新触发解决方案编译,即可正常通过。
内容的提问来源于stack exchange,提问作者bendecko
相关产品推荐
相关产品推荐

