当前位置：首页 > article >正文

在anaconda环境中构建flask项目的exe文件

article 2025/2/13 8:35:36

一、创建并激活虚拟环境

conda create -n flask_env python=3.9  # python版本根据项目需求安装
conda activate flask_env              # 激活环境

二、安装必要依赖

推荐使用conda，pip没尝试过，但是deepseek给出了命令

conda install flask                   # 通过conda安装Flask
pip install pyinstaller              # 通过pip安装打包工具
# 或
conda install -c conda-forge pyinstaller  # 通过conda-forge安装

三、准备Flask应用（app.py）

入口文件尤为重要，你的项目入口名称可能不叫app.py

from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello():
    return "Hello, Packaged Flask App!"

if __name__ == "__main__":
    app.run(debug=False)

四、创建PyInstaller spec文件（可选）

pyi-makespec app.py --name myapp --onefile

会生成一个. spec 文件，包含相关的配置项

五、关键配置调整

需要确保静态文件和模板被正确包含，修改.spec文件：

# 在Analysis部分添加数据文件
a = Analysis(
    ['app.py'],
    pathex=[],
    binaries=[],
    datas=[('templates/*', 'templates'), ('static/*', 'static')],  # 添加资源目录
    ...
)

同时需要在项目目录下新建 templates 和 static文件夹，如果已经有命名了作为 模板文件 和 静态资源 的文件夹，请替换上述相关的名称到配置中

六、处理路径问题（重要！）

在Flask应用中修改资源路径：

import sys
import os

def resource_path(relative_path):
    """ 获取资源的绝对路径"""
    if hasattr(sys, '_MEIPASS'):
        return os.path.join(sys._MEIPASS, relative_path)
    return os.path.join(os.path.abspath("."), relative_path)

# 使用示例
template_folder = resource_path('templates')
app = Flask(__name__, template_folder=template_folder)

七、执行打包命令

pyinstaller --onefile --name myapp --add-data "templates;templates" --add-data "static;static" app.py

如果项目比较大，可能打包构建的时间会比较长
打包完成后会生成以下两个文件夹，生成的exe文件为 myapp.exe

在这里插入图片描述

双击运行程序，如果出现相关的文件缺失，将缺失文件复制到dist文件夹下即可

八、验证打包结果

cd dist
./myapp.exe  # Windows直接双击运行

在这里插入图片描述

接下来就可以到服务器中做部署操作了

常见问题解决

文件体积过大：
- 使用conda clean --all清理缓存
- 添加--exclude-module排除不需要的模块

运行时提示缺失文件：

pyinstaller --hidden-import=werkzeug.serving ...

杀毒软件误报：
- 使用代码签名证书
- 添加白名单
控制台窗口隐藏：
```
pyinstaller --noconsole ...
```

完整打包示例命令

conda activate flask_env
pyinstaller --onefile --name MyFlaskApp \
--add-data "templates;templates" \
--add-data "static;static" \
--hidden-import=jinja2 \
--hidden-import=werkzeug.urls \
app.py