Frozen-Flask 是一个用于将 Flask 应用“冻结”为静态文件的 Python 扩展。它的核心用途是：将一个 Flask Web 应用生成成纯静态 HTML 文件，从而可以部署到静态网站托管服务上，如 GitHub Pages、Netlify 或任何支持静态文件的网站服务器。
🚀 主要用途
- 将 Flask 动态网站变成 静态网站，无须后端服务器支持。
- 用于构建博客、文档网站或展示页面等无需后端逻辑的项目。
🧊 Frozen-Flask 如何工作？
Frozen-Flask 会访问 Flask 应用中通过 url_for() 明确指定的页面路径，并将对应的 HTML 页面下载下来保存为 .html 文件。例如：
@app.route('/')
def index():
return render_template('index.html')
只要你在项目中使用 url_for('index') 或显式注册了路径，Frozen-Flask 就能把它保存为 index.html 文件。
✅ 使用步骤
- 安装：
pip install Frozen-Flask
- 创建一个
freeze.py文件：
from flask_frozen import Freezer
from myapp import app # 假设你的 Flask 实例在 myapp.py 中
freezer = Freezer(app)
if __name__ == '__main__':
freezer.freeze()
- 执行：
python freeze.py
这会生成一个 build/ 文件夹，其中包含了你整个网站的静态 HTML 文件结构。
⚠️ 注意事项
- 适用于没有用户交互、数据库写入等动态功能的项目。
- 如果你使用动态 URL（比如
/post/<id>），需要手动提供所有路径，告诉 Frozen-Flask 该生成哪些页面。 - 不支持动态 AJAX 请求或服务器端数据处理。
你可以通过定义一个 @freezer.register_generator 的函数来告诉它生成哪些动态路径，例如：
@freezer.register_generator
def post():
for post_id in range(1, 10):
yield {'id': post_id}
🔚 总结
Frozen-Flask 是一个将 Flask 网站导出为纯静态网站的工具，适用于博客、文档、展示类项目，不需要后端服务器，部署方便。
如果你打算将一个 Flask 项目变成可以放在 GitHub Pages 上的静态网页，Frozen-Flask 是个很合适的选择。
