为何PowerShell脚本无法通过dll.refresh文件检测并复制对应DLL？

问题本质 #

你处理的是传统ASP.NET Web Site项目（区别于Web Application项目），这类项目没有.csproj文件，依赖bin目录下的.refresh文件关联外部程序集。

VS打开项目时会自动执行以下操作：

• 读取.refresh文件里记录的dll路径
• 将目标dll复制到项目的bin目录
• 生成临时的.metaproj文件用于后续构建

但直接用MSBuild调用解决方案时，默认不会触发.refresh文件的解析与dll复制逻辑——Web Site项目的这部分处理属于VS内部的专属构建任务，单纯的MSBuild命令不包含这个步骤，导致编译时找不到foo.dll，抛出CS0246错误。

解决方案 #

1. 手动复制dll（临时快速方案） #

在PowerShell构建脚本开头添加复制步骤，把foo.dll从.refresh文件指向的路径复制到项目bin目录：

# 读取foo.dll.refresh里的目标路径
$dllPath = Get-Content "c:\abc\bin\foo.dll.refresh" -Raw | TrimEnd
# 复制到项目bin目录
Copy-Item -Path $dllPath -Destination "c:\abc\bin\" -Force

2. 调整MSBuild命令（推荐方案） #

使用VS自带的MSBuild，并直接针对网站目录构建，让它自动识别Web Site项目类型，触发.refresh文件的解析与dll复制流程：

& "C:\Program Files (x86)\Microsoft Visual Studio\2019\Professional\MSBuild\Current\Bin\MSBuild.exe" "c:\abc" /t:Build /p:Configuration=Debug

3. 迁移到Web Application项目（长远方案） #

如果项目允许重构，建议将Web Site转为Web Application项目：

• 这类项目有明确的.csproj文件，可直接可视化管理程序集引用
• 彻底摆脱.refresh文件这类遗留机制，构建流程更稳定可控

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