本地NuGet源开发困境：无需更新版本如何同步类库变更

一、解决当前变更不生效的问题 #

1. 清理NuGet本地缓存 #

执行以下命令清除所有NuGet缓存（全局缓存、HTTP缓存、本地源缓存），确保项目下次还原时读取本地源的新包：

dotnet nuget locals all --clear

2. 强制目标项目无缓存还原 #

在目标解决方案目录执行，禁止使用缓存，直接拉取本地源的最新包：

dotnet restore --no-cache

3. 验证包复制逻辑 #

检查类库csproj中的CopyPackage目标，确认SourceFiles路径是否匹配当前编译输出目录（比如Debug/Release），$(PackageId)和$(PackageVersion)是否与csproj中的配置一致，避免复制旧包文件：

<Target Name="CopyPackage" AfterTargets="Pack">
  <Copy SourceFiles="./bin/Debug/$(PackageId).$(PackageVersion).nupkg" DestinationFolder="path/to/local/nuget/packages" />
</Target>

二、优化开发工作流（无需更新主版本） #

1. 使用动态预发布版本后缀 #

在类库csproj中添加动态版本后缀，生成唯一的预发布包，既保留主版本，又避免覆盖旧包：

<PropertyGroup>
  <Version>1.0.0</Version>
  <!-- 基于时间戳生成唯一后缀，确保每次打包版本唯一 -->
  <VersionSuffix>dev.$([System.DateTime]::Now.ToString("yyyyMMddHHmmss"))</VersionSuffix>
</PropertyGroup>

打包后版本为1.0.0.dev.20240520123456，NuGet会自动识别为新的预发布版本，无需清理缓存。

2. 自动化打包、复制与还原 #

• 完善类库打包后逻辑：添加清理旧预发布包的步骤，避免本地源堆积：

  <Target Name="CopyPackage" AfterTargets="Pack">
    <!-- 删除本地源中同主版本的旧预发布包 -->
    <Delete Files="path/to/local/nuget/packages/$(PackageId).$(Version)*.nupkg" />
    <!-- 复制新包到本地源 -->
    <Copy SourceFiles="$(OutputPath)$(PackageId).$(PackageVersion).nupkg" DestinationFolder="path/to/local/nuget/packages" />
  </Target>
  

• 自动监听类库变更打包：使用dotnet watch自动监听文件变更，触发打包：

  dotnet watch pack --no-restore
  

• 目标项目自动还原：在目标项目目录执行dotnet watch restore，或在启动命令中添加还原逻辑，确保获取最新包。

3. 配置全局本地NuGet源 #

将本地源添加到全局配置，避免每次添加包时指定--source：

dotnet nuget add source "path/to/local/nuget/packages" --name LocalDevSource

4. 锁定目标项目的NuGet源 #

在目标解决方案根目录创建NuGet.Config，指定仅使用本地源，避免从公共源拉取旧版本：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="LocalDevSource" value="path/to/local/nuget/packages" />
  </packageSources>
</configuration>

内容的提问来源于stack exchange，提问作者monty.py