打包 Windows 应用 (Packaging app for Windows)

---

本指南介绍了将 Flet 应用打包为 Windows 应用程序的详细步骤。

提示

本指南提供了专门针对 Windows 平台的详细信息。更通用和互补的打包信息，请参阅发布 Flet 应用。

前提条件 (Prerequisites)

Visual Studio

你需要安装 Visual Studio（2022 或 2026），并安装了 "使用 C++ 的桌面开发" (Desktop development with C++) 工作负载。

关于为 Flutter 桌面端开发下载并安装正确的 Visual Studio 组件的说明，请参考此指南。

---

flet build windows

提示

此命令只能在 Windows 上运行。

构建 Windows 应用程序。

Windows on ARM

在 ARM64 PC（例如搭载骁龙处理器的笔记本）上，flet build windows 会构建一个 x64 应用，该应用通过 Windows 内置的 x64 模拟层运行。Flet 在 Windows 上的 Python 运行时仅支持 x64，因此即使 PATH 中存在 ARM64 的 Flutter SDK，Flet 仍会使用其自带的、同样为 x64 的 Flutter SDK 进行构建。应用在模拟层下的首次启动会明显更慢。

---

常见故障排查 (Troubleshooting)

开发者模式 (Developer mode)

如果你遇到以下报错错误：

Building with plugins requires symlink support.

Please enable Developer Mode in your system settings. Run
  start ms-settings:developers
to open settings.

那么你需要按照提示启用系统中的开发者模式。你可以根据此指南来了解具体的操作步骤，或者通过在命令提示符/PowerShell 中运行 start ms-settings:developers 来快速打开相关的系统设置页面。