VS2019发布Python Flask应用到文件系统显示成功但目标路径无文件

基础环境与故障复现记录 #

• 开发侧环境：Windows 10 1909，Visual Studio 2019 版本16.9.2，Python工作负载版本16.9.21026.1
• 目标托管环境：Windows Server 2016 服务器 + IIS 组件
• 测试基础：使用未做修改的官方"Flask Web Project"模板创建的项目，开发环境下可正常运行
• 发布操作记录：先后尝试将项目发布到两个路径：.\app.publish（完整路径C:\Apps_VS2019\FlaskDemoApp\FlaskDemoApp\app.publish）、C:\Apps_VS2019\Pub，两个路径均已为所有用户配置完全控制权限
• 故障现象：VS操作提示发布成功，但指定发布路径下无任何文件生成；仅在C:\Apps_VS2019\FlaskDemoApp\FlaskDemoApp\obj\Any CPU\Debug\Package\PackageTmp目录生成了文件，包含：FlaskDemoApp文件夹、requirements.txt、runserver.py；其中FlaskDemoApp文件夹内的static、templates、init.py、views.py内容符合预期，但未包含click、Flask、itsdangerous、Jinja2、MarkupSafe、Werkzeug等第三方依赖
• 现有发布配置：FolderProfile1.pubxml 文件路径为C:\Apps_VS2019\FlaskDemoApp\FlaskDemoApp\PublishProfiles，配置内容为：

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <DeleteExistingFiles>False</DeleteExistingFiles>
    <ExcludeApp_Data>False</ExcludeApp_Data>
    <LaunchSiteAfterPublish>True</LaunchSiteAfterPublish>
    <LastUsedBuildConfiguration>Release</LastUsedBuildConfiguration>
    <LastUsedPlatform>Any CPU</LastUsedPlatform>
    <PublishProvider>FileSystem</PublishProvider>
    <PublishUrl>C:\Apps_VS2019\Pub</PublishUrl>
    <WebPublishMethod>FileSystem</WebPublishMethod>
  </PropertyGroup>
</Project>

• 附加观察：项目全程使用Debug/Any CPU配置开发，但发布配置中指定的发布构建配置为Release，项目根目录下未生成Release或Debug文件夹

核心问题解答 #

1. 为何发布操作提示成功但目标路径下无任何文件？ #

该故障是构建配置不匹配导致的静默发布异常，原因与修复方式如下：

• 根因：发布配置中指定发布使用Release构建配置，但本地从未完成过该配置下的项目构建，无对应版本的构建中间产物。VS发布流程会先按指定配置生成临时包目录（即PackageTmp），再将目录内容复制到目标发布路径。当构建配置与本地实际存在的构建产物不匹配时，MSBuild会静默跳过跨配置的复制步骤，仅返回发布成功提示，不会抛出明确报错。
• 修复步骤：
  • 将pubxml文件中的LastUsedBuildConfiguration值修改为与日常开发一致的Debug
  • 手动删除obj目录下的旧PackageTmp缓存文件夹
  • 重新执行发布操作，即可正常将文件写入指定发布路径

2. 上述PackageTmp目录的内容是否符合发布预期？ #

VS Python工作负载下的Flask项目，默认生成的PackageTmp目录内容完全符合发布预期。和.NET项目的发布逻辑不同，Python项目是解释执行模式，VS默认发布流程仅会收集三类内容：项目自身的代码与静态资源、启动脚本（runserver.py）、依赖声明文件（requirements.txt），不会自动打包虚拟环境内的第三方依赖，因此目录中看不到Flask、Jinja2这类包是正常的默认行为，不属于发布异常。

3. Flask、Jinja2这类外部依赖包在发布流程中应当被放置在什么位置？ #

第三方依赖的放置位置可根据托管场景选择：

• 标准IIS托管场景：不需要将依赖打包到项目发布目录。在目标Windows Server 2016服务器上安装对应版本的Python解释器，创建独立虚拟环境，通过pip install -r requirements.txt将所有依赖安装到该虚拟环境目录下，后续配置IIS的wfastcgi模块时，直接指定该虚拟环境的python.exe作为解释器路径即可。这种方式和VS默认发布逻辑完全匹配，维护成本低。
• 便携部署场景：如果不希望依赖服务器上的独立Python环境，可以在VS发布配置的高级选项中勾选"包含虚拟环境中的所有第三方库"，重新执行发布后，所有依赖包会被打包到发布目录下的同级lib子文件夹中，和项目代码绑定，无需在服务器上单独安装依赖。

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