VSO MSBuild路径格式不支持：60项目CI搭建中4个项目报错求助

嘿，针对你那60个项目里4个踩坑的情况，我整理了几个实际项目里用过的有效排查和修复方案，都是能快速定位问题的方向：

1. 先查项目发布配置里的路径 #

打开出错项目的Publish Profile（就是.pubxml文件），重点看PublishUrl、PackageOutputPath这些路径属性：

• 别让路径里混着特殊字符，比如中文、全角符号、|、?这类Windows不认的玩意儿
• 用相对路径的话，别瞎写../，确保是基于项目根目录的有效层级，别搞出不存在的路径
• 路径里有空格的话，虽然MSBuild一般能处理，但手动输入的话别多打空格或者嵌套引号，容易出问题
• 嫌麻烦就直接在VS的项目属性“发布”选项卡里重新选个输出路径，让系统自动生成正确格式

2. 检查项目文件里的Web Deploy配置 #

错误指向Microsoft.Web.Publishing.targets的3507行，这行是处理清单生成的，大概率是某个属性值不对：

• 用记事本或者VS打开项目的.csproj/.vbproj文件，搜GenerateMsdeployManifestFiles相关配置
• 看看有没有自定义的MsDeployManifestFileName、SourceManifestPath这类属性，确保它们的值是有效路径，别是空的或者格式乱了
• 如果项目导入了自定义的.targets文件，查一查是不是这些文件覆盖了Web Deploy的默认路径设置

3. 排查CI环境的特殊情况 #

毕竟本地可能正常，CI环境容易有坑：

• 看看CI代理的工作目录路径是不是太长了，Windows默认路径不能超过260字符，太长就缩短工作目录或者开长路径支持
• 检查CI构建时的MSBuild参数，有没有传错/p:PackageOutputPath或者/p:PublishUrl，这些参数会直接覆盖项目里的配置
• 确认CI代理的账号能访问构建输出目录，权限不够也可能导致路径解析失败

4. 实在不行就修复VS组件 #

如果上面都没问题，可能是CI代理上的VS Web Deploy组件坏了：

• 打开VS安装器，修复Visual Studio 2017 Community的Web开发组件，确保Microsoft Web Deploy相关的都装全了
• 清一下CI环境的MSBuild缓存，删掉%USERPROFILE%\.nuget\packages和%LOCALAPPDATA%\Temp\MSBuild里的缓存文件，再重新构建

临时调试小技巧 #

在CI构建命令里加个/v:detailed参数，能输出详细的MSBuild日志，就能看到具体是哪个路径解析出问题了：

msbuild YourSolution.sln /v:detailed /p:Configuration=Release /p:DeployOnBuild=true

补充：这种错误90%都是路径配置的锅，建议你对比一下出错项目和正常项目的发布配置、项目文件差异，很快就能找到问题所在。

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