GitHub Action可重用工作流：安装Python库因缺失模块失败

问题根源 #

核心原因大概率是以下二者之一：

• Python环境与pip不匹配：你使用的pip命令对应系统默认Python环境，而非setup-python安装的目标Python版本，导致packaging被装到了错误环境中，运行时用的Python无法找到它。
• 包构建阶段依赖缺失：你的my_lib在构建过程中（比如setup.py里需要解析版本）依赖packaging，但未在构建配置中声明，即使提前在用户环境安装了packaging，pip默认的构建隔离环境依然会缺失该依赖，导致构建失败，最终my_lib未正确安装。

具体解决方案 #

方案一：强制使用目标Python对应的pip #

将所有pip命令替换为python -m pip，确保操作的是setup-python配置的Python环境，彻底避免环境不匹配问题：

python --version
python -m pip install -r ./Repo_Folder/requirements.txt
python -m pip install ./Repo_Folder
python -c 'import my_lib; print(my_lib.__version__)'

方案二：正确配置构建依赖（推荐） #

如果my_lib的构建过程需要packaging，直接在my_lib的pyproject.toml中声明构建阶段依赖，让pip自动在隔离环境中安装所需依赖，无需手动提前安装：

[build-system]
requires = ["setuptools>=61.0", "packaging>=22.0"]
build-backend = "setuptools.build_meta"

配置后，你甚至可以去掉手动安装requirements.txt的步骤（如果requirements.txt里的依赖已经在setup.py或pyproject.toml的install_requires中声明）。

方案三：联合两种方案（最稳妥） #

同时使用python -m pip和正确的构建依赖配置，既避免环境冲突，又规范构建流程。

为什么之前的尝试无效 #

• 添加--no-build-isolation：如果没有对应到正确的pip命令，或者没把参数加到pip install ./Repo_Folder这一步，依然无法解决构建隔离或环境不匹配的问题。
• 转换为pyproject.toml：未配置build-system的requires字段，构建隔离环境依然缺失packaging依赖。
• 开关setup-python缓存：缓存只影响依赖包的复用，不解决环境不匹配或构建依赖缺失的核心问题。

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