Visual Studio项目发布需按目标选择路径：文件夹适合本地测试，Azure需登录且限新框架，FTP/FTPS须配对端口与TLS，容器注册表仅支持Docker项目；.pubxml配置决定文件包含逻辑，如未设CopyToPublishDirectory则自定义配置文件不发布，ExcludeFilesFromDeployment可排除指定DLL；发布模式选Release+独立部署才生成可双击.exe，框架依赖型需目标机预装对应.NET Runtime，web.config或appsettings.Production.json缺失将导致静默500错误。

Visual Studio 项目发布不是“点一下就完事”，关键看你要发到哪儿、用什么方式、是否要给别人运行——不同目标对应完全不同的操作路径和陷阱。

右键“发布”后选错目标，文件就发错地方

在 解决方案资源管理器 中右键项目 → 选择 发布，第一步必须明确目标类型：

• 文件夹：适合本地测试、局域网共享或作为后续打包（如 MSI）的原始输出。路径填 c:\deploy\myapp 即可，别用带空格或中文的路径，否则某些部署工具会报 MSB4018 错误
• Azure：需提前登录 Azure 账户，且项目必须是 ASP.NET Core / .NET 6+ 或支持的类型；老式 .NET Framework Web 项目选这个可能卡在凭据验证
• FTP/FTPS：必须填对 服务器地址、用户名、密码 和 目标路径（如 /public_html），注意 FTPS 默认端口是 21，但有些主机要求显式启用 TLS 模式，否则连接后上传失败却无提示
• 容器注册表（如 Docker Hub、ACR）：只对启用了 Docker 支持的项目有效（.csproj 中含 <DockerfileContext>），否则向导直接跳过该选项

发布配置文件（.pubxml）改错一个属性，整个包就缺文件

发布配置本质是 MSBuild 的 .pubxml 文件，存放在 Properties\PublishProfiles\ 下。常见问题集中在文件包含逻辑上：

Visual Studio Professional 18.8.1

Visual Studio 18.8.1 官方固定版本安装引导程序，当前条目使用微软发布历史中的 Professional Web Installer，适合旧项目兼容、环境回退、复现特定构建链和排查版本差异等场景。

下载

• 默认只发布 Content 项（如 wwwroot\**、**\*.json、**\*.cshtml），但你手动加的配置文件（比如 app.settings.prod.json）若没设 CopyToPublishDirectory=PreserveNewest，它根本不会进 publish 文件夹
• 想排除某个 DLL？不能只在解决方案里“排除”，得在 .pubxml 的 <PropertyGroup> 里加：
  

  <ExcludeFilesFromDeployment>Newtonsoft.Json.dll</ExcludeFilesFromDeployment>

• <WebPublishMethod>FileSystem</WebPublishMethod> 对应文件夹发布，MSDeploy 对应 IIS 部署，混用会导致 ERROR_DESTINATION_INVALID

控制台或 Web 项目发布后双击不运行？检查发布模式

发布配置里的“配置”下拉框（Debug/Release）直接影响输出类型：

• .NET 6+ 控制台项目选 Release + 框架依赖型部署 → 输出是 .dll，必须用 dotnet MyApp.dll 运行，双击无效
• 要生成能双击的 .exe，得勾选 独立部署 并指定运行时（如 win-x64），但体积会从几百 KB 涨到 ~80MB
• ASP.NET Core Web 项目若发布为框架依赖型，目标机器必须装对应版本的 .NET Runtime（不是 SDK）；漏装会报 The specified framework 'Microsoft.AspNetCore.App', version '8.0.0' was not found

最易被忽略的是：发布后的 publish 文件夹里没有 web.config（ASP.NET Core）或缺少 appsettings.Production.json（未设 IsTransformWebConfigRequired 为 false），这类缺失不会中断发布流程，但应用启动就 500 —— 它们不会报错，只会静默失败。