如何用MSBuild通过命令行发布C# ASP.NET Web应用到本地文件夹

你当前开发的是传统.NET Framework承载的ASP.NET Web应用（而非跨平台的.NET Core/.NET 5+项目），这类项目的命令行发布依赖MSBuild工具，不能直接套用dotnet CLI的发布命令，以下是可直接落地的操作流程：

1. 准备命令行环境 #

新手最容易踩的坑是手动找MSBuild的全路径输错位置，最稳妥的方式是直接调用Visual Studio自带的开发者命令提示符：

• 在Windows开始菜单搜索「Developer Command Prompt for VS 2022」（根据自己安装的VS版本选2019/2022对应项），打开后该环境会自动配置好MSBuild的调用路径，不需要手动拼接程序全路径。
• 用cd命令切换到项目根目录，也就是存放.csproj项目文件、Web.config的文件夹路径下。

2. 直接执行发布命令 #

在当前打开的命令行窗口输入以下命令，替换对应占位内容即可正常运行：

MSBuild MyWebApiProject.csproj /p:Configuration=Release /p:DeployOnBuild=true /p:WebPublishMethod=FileSystem /p:publishUrl=D:\LocalPublish\MyApiOutput

各参数的实际作用：

• Configuration=Release：指定以正式发布配置构建，输出不带调试冗余的程序文件
• DeployOnBuild=true：触发构建完成后的发布流程，避免只编译不输出部署文件
• WebPublishMethod=FileSystem：指定发布目标为本地文件系统，而非IIS、FTP等其他部署目标
• publishUrl=D:\LocalPublish\MyApiOutput：替换成你自己想要存放发布文件的本地绝对路径即可，目标文件夹不存在时命令会自动创建

3. 常见问题排查 #

• 不要混用dotnet CLI命令：网上流传的dotnet publish仅适用于.NET Core/.NET 5+的项目，传统.NET Framework项目使用该命令会出现框架找不到、输出文件缺失的报错，不要尝试套用。
• 如果执行命令时报「找不到Web发布目标」：只需要在Visual Studio里右键对应项目 → 选择「发布」 → 目标选「文件夹」，走完前置向导直到进入发布确认页，不需要真的点击发布按钮，VS会自动把发布需要的配置项写入项目文件，之后回到命令行重新执行上面的命令即可正常运行。
• 命令执行完成后，打开你指定的本地输出文件夹，所有可部署的API程序集、配置文件、静态资源都会完整生成，不需要额外拷贝其他依赖文件。

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