在使用 PyInstaller 打包 Flask 应用为可执行文件（exe）后运行时，如果提示找不到 Flask 模块，通常是由以下几个原因导致的： ### 1. **Flask 依赖未被正确打包** PyInstaller 在打包过程中可能会遗漏某些隐式依赖或动态导入的模块。Flask 本身可能没有被完全识别并包含进最终的可执行文件中。 解决方案： - 明确指定需要包含的模块，使用 `--hidden-import` 参数来强制将 Flask 及其子模块加入打包范围。 示例命令： ```bash pyinstaller --onefile --hidden-import=flask --hidden-import=flask.app app.py ``` ### 2. **Python 环境路径问题** 在某些情况下，PyInstaller 使用的是系统的默认 Python 解释器路径，而不是虚拟环境中安装 Flask 的路径。这会导致打包时使用的解释器无法找到 Flask 模块。 解决方案： - 使用虚拟环境管理依赖，并确保 PyInstaller 是在该虚拟环境中运行的。 - 可以通过激活虚拟环境后运行以下命令确认当前使用的 Python 和 PyInstaller 是否属于虚拟环境： ```bash which python which pyinstaller ``` ### 3. **缺少必要的数据文件** Flask 应用依赖于模板、静态资源等外部文件。如果没有正确地将这些资源添加到打包配置中，应用在运行时也可能报错。 解决方案： - 使用 `--add-data` 参数将模板和静态文件目录添加到打包命令中。 示例命令： ```bash pyinstaller --onefile --add-data="templates;templates" --add-data="static;static" app.py ``` 此外，在代码中也需要根据实际路径调整 Flask 应用的模板和静态文件夹设置，例如： ```python import os import sys from flask import Flask # 获取当前脚本所在目录 current_directory = os.path.dirname(os.path.realpath(sys.argv[0])) template_path = os.path.join(current_directory, 'templates') static_path = os.path.join(current_directory, 'static') app = Flask(__name__, template_folder=template_path, static_folder=static_path) @app.route('/') def hello_world(): return 'Hello, World!' if __name__ == '__main__': app.run() ``` ### 4. **PyInstaller Hook 文件缺失** 某些第三方库需要特定的 PyInstaller hook 文件来正确打包。如果 Flask 或其依赖的 hook 文件缺失，也会导致打包失败。 解决方案： - 确保 PyInstaller 安装完整，并检查 `hooks` 目录下是否有相关的 `.py` 文件用于支持 Flask。 - 如果发现 hook 文件确实缺失，可以从官方仓库获取相关 hook 文件并放置在项目目录下的 `hooks` 文件夹中。 ### 5. **运行环境与打包环境不一致** 有时候开发环境和运行环境存在差异，特别是在使用 IDE（如 PyCharm）进行开发和调试时，IDE 的自动加载机制可能导致某些依赖没有被正确识别。 解决方案： - 推荐使用命令行工具（如 CMD 或 PowerShell）进行打包操作，以确保打包环境更贴近实际运行环境[^4]。 ---