Fooocus项目在Python 3.12环境下PyYAML依赖问题的解决方案

问题背景

在使用Fooocus项目时，部分用户在Python 3.12环境下遇到了PyYAML 6.0版本安装失败的问题。这个问题主要出现在Ubuntu 24.04 LTS系统中，当用户按照标准安装流程创建虚拟环境并安装依赖时，pip在安装PyYAML 6.0时会抛出构建错误。

错误分析

从错误日志可以看出，问题源于PyYAML 6.0在Python 3.12环境下的兼容性问题。具体表现为在构建过程中出现了"AttributeError: cython_sources"错误，这表明PyYAML的构建系统在尝试访问一个不存在的属性。这种问题通常发生在软件包与Python新版本不完全兼容的情况下。

解决方案

经过实践验证，以下是可行的解决方案：

1. 修改依赖版本要求：将requirements_versions.txt文件中PyYAML的版本要求从"==6.0"改为">=6.0"，这样可以允许安装更新的兼容版本。

2. 保持gradio版本固定：虽然可以放宽大多数依赖的版本要求，但gradio的版本需要保持固定为3.41.2，因为新版本可能引入不兼容的API变更。

3. ROCm用户额外步骤：对于使用AMD显卡的用户，在安装完基本依赖后，需要卸载默认安装的torch包，然后安装针对ROCm优化的版本。

完整安装流程

1. 克隆项目仓库并创建虚拟环境
2. 修改requirements_versions.txt文件，将"=="改为">="（gradio除外）
3. 安装Python依赖
4. 对于ROCm用户，重新安装针对ROCm优化的PyTorch版本
5. 启动Fooocus应用

技术建议

1. 依赖管理最佳实践：在Python项目中，使用过于严格的版本限制（==）可能会导致兼容性问题，特别是在新Python版本下。建议在可能的情况下使用兼容性版本说明符（如>=, ~=）。

2. 虚拟环境隔离：使用Python虚拟环境可以有效隔离不同项目的依赖，避免系统级Python环境被污染。

3. 错误排查方法：当遇到类似构建错误时，可以尝试以下步骤：

   • 检查软件包的最新版本是否修复了该问题
   • 查看软件包的issue tracker是否有类似报告
   • 尝试在较低版本的Python环境中安装

通过以上方法，用户应该能够在Python 3.12环境下成功安装和运行Fooocus项目。