vcpkg专为c/c++设计，处理.lib/.dll和头文件，依赖c++运行时配置；c#依赖.net元数据和程序集加载机制，与vcpkg二进制模型不兼容，强行使用会导致dllnotfoundexception、badimageformatexception等运行时错误。
NuGet 是 Visual Studio 中管理 C# 第三方库的唯一推荐方式，vcpkg 不适用、项目引用不适用于外部库、手动拷贝 DLL 容易出错且无法自动更新。
为什么不能用 vcpkg 管理 C# 库
vcpkg 是专为 C/C++ 设计的包管理器，它处理的是 .lib、.dll 和头文件，依赖 C++ 运行时配置（如 /MD）、平台工具集和静态/动态链接策略。C# 项目编译后生成的是 .dll 或 .exe，但其依赖机制基于 .NET 元数据和程序集加载（AssemblyLoadContext），与 vcpkg 的二进制分发模型完全不兼容。
尝试将 vcpkg 输出的 C++ 库直接“引用”进 C# 项目会导致：
-
System.DllNotFoundException：找不到原生 DLL（即使路径正确，也可能因架构或运行时不匹配） -
BadImageFormatException：x86/x64 混用，或 .NET Core/.NET Framework 加载了不兼容的本机模块 - 构建时无报错，运行时报错——因为 vcpkg 不参与 MSBuild 的
ResolveAssemblyReferences过程
添加 NuGet 包的三种可靠路径
所有操作都应在 Visual Studio 的“解决方案资源管理器”中右键点击项目 → “管理 NuGet 包”完成；命令行仅作补充，不推荐新手直接用 dotnet add package。
-
官方源安装：默认启用
https://api.nuget.org/v3/index.json，搜索包名（如Newtonsoft.Json）→ 选中 → “安装”。这是最常用方式，适合绝大多数开源类库 - 私有源安装：若公司有内部 NuGet 服务器（如 Azure Artifacts、ProGet），需先在“工具 → NuGet 包管理器 → 包源管理器”中添加源 URL 和凭据，再切换源进行安装
-
本地包安装：把
.nupkg文件放在本地文件夹（如./packages/），添加该文件夹为源（URL 填路径，如C:\myproject\packages），即可离线安装。注意：此方式不解决依赖传递，需自行确保所有依赖包都在该目录中
引用失败常见原因与自查清单
安装成功但编译报 The type or namespace name 'xxx' could not be found，大概率不是包没装上，而是环境错配。
- 检查目标框架是否匹配：比如安装了
Microsoft.EntityFrameworkCore.SqlServer 8.0.0，但项目是.NET 6.0，就会失败——NuGet 包的lib/net6.0/目录下必须有对应输出 - 确认包是否为“纯 .NET”而非“绑定原生库”：例如
SkiaSharp在 Windows 上依赖skia-native.dll，需额外确保运行时能加载该 DLL（通常由 NuGet 自动复制到输出目录，但若禁用了CopyLocalLockFileAssemblies就会丢失） - 清理并重试：
Build → Clean Solution→ 删除bin/和obj/→ 重新Restore（右键解决方案 → “还原 NuGet 包”） - 检查
.csproj中是否残留手动添加的<reference include="..."></reference>，这会干扰 NuGet 的自动引用解析
包版本冲突时实际怎么处理
NuGet 不会自动降级或覆盖已安装的包，冲突往往发生在多个项目共用一个解决方案、且各自引用不同主版本时（如 A 项目用 System.Text.Json 6.0.0，B 项目用 7.0.0）。
- MSBuild 默认采用“最高版本优先”策略，但仅限于同一程序集名+相同公钥令牌。若两个包提供同名类型但签名不同，就会触发
CS1705错误 - 解决方法不是删包，而是统一升级：在“管理 NuGet 包”界面切换到“解决方案”视图，勾选所有项目，然后批量更新到兼容的最低共同版本（例如都升到
7.0.5） - 若必须保留旧版（如某 SDK 强制绑定
5.0.0），可添加<packagereference update="System.Text.Json" version="5.0.0"></packagereference>到项目文件顶部，强制锁定版本
真正麻烦的从来不是“怎么加包”，而是“加完之后类型对不上、运行时找不到、多项目间版本打架”——这些细节藏在 .csproj、obj/project.assets.json 和最终输出目录的结构里，不能只靠 UI 点几下就认为万事大吉。
