如何正确引用NuGet包避免硬编码路径？通用库引用方式咨询

一、避免硬编码路径的核心：别手动找DLL！用NuGet自带机制 #

你现在遇到的分支路径问题，本质是手动去packages文件夹里选DLL引用导致的——这完全没必要！NuGet本身就内置了相对路径+变量替换的逻辑，能自动帮你处理路径，根本不用硬编码任何分支或绝对路径。

正确的操作应该是：

• 右键项目 → 选择「管理NuGet程序包」（如果找不到这个选项，往下看解决办法）
• 在「浏览」标签搜索你要的包，点击「安装」——NuGet会自动完成这些事：
  1. 把包下载到解决方案根目录的packages文件夹（默认位置，可通过NuGet.Config调整）
  2. 在项目文件（.csproj/.vbproj）里添加引用，路径会用相对路径或NuGet内置变量（比如$(SolutionDir)packages\...），绝对不会出现你的TFS分支路径
  3. 自动生成依赖记录（旧格式是packages.config，新格式直接写在项目文件里）

二、NuGet库的最佳引用方式：首选PackageReference #

强烈推荐用PackageReference格式（Visual Studio 2017及以上默认支持），比旧的packages.config好用太多：

• 项目文件更干净，依赖直接写在.csproj里，不用额外维护packages.config
• 自动处理传递依赖，不用手动引用子库
• 路径完全由NuGet解析，从根源避免硬编码问题
• 支持中央包管理（Central Package Management）这类现代功能，统一管理多项目的包版本

如果你的项目还在用packages.config，右键项目 → 选择「迁移PackageReference」就能升级。

三、移除引用中的TFS分支路径 #

如果已经手动加了带分支路径的错误引用，按这几步修复：

1. 先删掉错误引用：右键项目里的对应引用 → 「移除」
2. 打开项目文件（.csproj），检查有没有残留的绝对路径，手动替换成相对路径或NuGet变量：
   • 比如把C:\TFS\MyBranch\packages\XXX.dll改成$(SolutionDir)packages\XXX.1.2.3\lib\net6.0\XXX.dll
   • 最省心的方式是直接通过NuGet重新安装该包，它会自动生成正确的引用路径
3. 确认你的NuGet.Config里的repositoryPath是相对路径（默认就是相对于解决方案根目录的packages，不用改）

四、找不到「已安装包」选项的解决办法 #

如果右键项目看不到「管理NuGet程序包」或「已安装包」，试试这些方案：

• 检查Visual Studio版本：确保是2015及以上，旧版本的NuGet集成功能有限
• 启用NuGet包管理器：工具 → 选项 → NuGet包管理器 → 常规，勾选「允许NuGet下载缺失的包」和「自动检查更新」
• 重置VS设置：工具 → 导入和导出设置 → 重置所有设置，有时候UI组件异常会导致选项消失
• 用命令行替代：工具 → NuGet包管理器 → 包管理器控制台，用命令安装包，比如Install-Package Newtonsoft.Json，同样能自动添加正确的引用

最后再啰嗦一句：永远别手动引用packages文件夹里的DLL，让NuGet来处理所有引用和路径问题——这才是它设计的初衷啊！

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