GitHub Python仓库构建报错‘Build: process completed with exit code 5’如何解决？

• 检查工作流权限设置
  Exit Code 5大概率和权限不足相关，尤其是新建仓库的默认权限可能受限。进入仓库「Settings」→「Actions」→「General」，找到「Workflow permissions」选项，勾选「Read and write permissions」后保存，再重新运行工作流。

• 排查依赖安装问题
  如果工作流包含依赖安装步骤，先确认requirements.txt或pyproject.toml里的依赖是否存在版本错误、不存在的包名。同时可以在安装依赖前升级pip：

pip install --upgrade pip
pip install -r requirements.txt

避免因pip版本过低导致的兼容故障。

• 定位工作流命令错误
  如果工作流里有自定义执行命令（比如测试、打包脚本），Exit Code 5可能是命令执行失败触发的。可以在工作流脚本中添加set -x开启命令日志，或者拆分命令分步执行，找到具体出错的步骤，检查路径、文件是否存在，脚本逻辑是否有问题。

• 确认Python版本匹配
  检查工作流配置文件（如.github/workflows/build.yml）中的python-version设置，确保和项目实际使用的Python版本兼容。比如项目基于Python3.10开发，就不要在工作流里指定3.12，避免依赖或代码运行报错。

• 清理缓存重试
  GitHub Actions的缓存可能残留旧文件导致冲突。可以在工作流运行记录页面选择「Re-run jobs without using cache」，或者在工作流中添加缓存清理步骤，再重新执行构建。

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