Flask部署GitHub Pages时/venv/bin/python符号链接报错如何解决

1 处理虚拟环境目录报错 #

你遇到的符号链接报错核心原因是本地venv虚拟环境目录被提交到了Git仓库，venv内的文件、符号链接均为本地环境专属，指向你本机的Python路径，不需要同步到远程仓库，按以下步骤处理即可：

• 移除仓库中已提交的venv目录，执行命令：
  git rm -r --cached venv
• 在项目根目录新建.gitignore文件，添加以下规则，避免后续再提交本地环境相关文件：

venv/
__pycache__/
*.pyc
*.pyo
*.pyd
.env
.flaskenv

• 提交修改到远程仓库：

git add .gitignore
git commit -m "移除venv目录提交，添加gitignore规则"
git push

完成这一步后，符号链接的报错会直接消失。

2 适配GitHub Pages的发布要求 #

GitHub Pages是静态站点托管服务，原生不支持运行Flask这类Python后端应用，就算解决了符号链接报错，也无法直接部署运行Flask服务，需要先将Flask应用预渲染为静态站点资源：

• 安装Frozen-Flask依赖完成静态导出：
  pip install Frozen-Flask
• 在Flask启动文件（通常为app.py）中添加导出配置，示例代码如下：

from flask_frozen import Freezer
# 此处app对应你的Flask实例名称
freezer = Freezer(app)

if __name__ == '__main__':
    freezer.freeze()

• 运行启动文件，项目根目录会自动生成build文件夹，里面是预渲染完成的全量静态站点资源。

3 发布静态站点 #

在GitHub仓库的Pages设置页，指定发布源为build目录所在的分支和路径，或是将build目录内容提交到gh-pages分支，即可正常发布站点。

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