开发模式下自定义MSBuild任务的文件锁定问题求助

问题背景 #

按照微软官方示例开发自定义MSBuild任务，通过<UsingTask>在测试项目中引用。修改任务实现后，构建时出现文件锁定错误：

Severity Code Description Project File Line Suppression State
Warning MSB3026 Could not copy "obj\Debug\netstandard2.0\AppSettingStronglyTyped.dll" to "bin\Debug\netstandard2.0\AppSettingStronglyTyped.dll". Beginning retry 1 in 1000ms. The process cannot access the file 'bin\Debug\netstandard2.0\AppSettingStronglyTyped.dll' because it is being used by another process. The file is locked by: "MSBuild.exe (760)" AppSettingStronglyTyped D:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Current\Bin\amd64\Microsoft.Common.CurrentVersion.targets 4734

每次修改任务都需要重启Visual Studio才能测试，开发效率极低；尝试用本地NuGet源分发任务DLL，但存在Visual Studio缓存延迟问题，需等待3分钟或重启VS才能生效。

当前临时解决方法：重启Visual Studio，重新构建任务项目，再构建测试项目。期望修改任务后无需重启VS即可同步测试。

解决方案 #

1. 启用CopyLocalLockFileAssemblies属性 #

在测试项目（MSBuildConsoleExample.csproj）中添加以下属性配置，让依赖程序集复制到独立缓存区，避免被MSBuild进程锁定：

<PropertyGroup>
  <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
</PropertyGroup>

2. 关闭MSBuild进程重用 #

• 打开Visual Studio的工具 > 选项 > 项目和解决方案 > 生成并运行
• 取消勾选重用MSBuild进程（如果可用）
• 重启一次VS后，后续构建会每次启动新的MSBuild进程，避免长期锁定旧DLL文件。

3. 动态加载obj目录的任务DLL（推荐） #

修改测试项目的<UsingTask>配置，指向任务项目的obj目录而非bin目录，同时添加构建前清理逻辑：

<UsingTask TaskName="AppSettingStronglyTyped.GenerateAppSettings" AssemblyFile="..\AppSettingStronglyTyped\obj\$(Configuration)\netstandard2.0\AppSettingStronglyTyped.dll" />

<Target Name="CleanTaskAssembly" BeforeTargets="Build">
  <Delete Files="..\AppSettingStronglyTyped\bin\$(Configuration)\netstandard2.0\AppSettingStronglyTyped.dll" />
</Target>

obj目录的文件不会被MSBuild长期占用，构建前清理bin目录旧文件，确保每次使用最新编译版本。

4. 使用命令行构建替代VS内部构建 #

打开命令提示符或PowerShell，进入测试项目目录执行构建命令：

dotnet build

命令行构建不占用VS的MSBuild进程，修改任务后重新编译任务项目，再执行该命令即可完成测试，无需重启VS。

内容的提问来源于stack exchange，提问作者Anna Naumova