升级Python到3.11.4后无法安装gala包且降级失败，求解决方案

问题背景 #

升级Python到3.11.4后，系统Python环境混乱，大量第三方包无法正常工作，核心依赖的gala包完全无法安装。已尝试卸载重装Anaconda，但执行pip install gala时会长时间卡在Solving Environment:环节；尝试通过conda install python=3.8.8降级Python至适配gala的版本也失败，工作严重受阻。

关键错误信息 #

编译依赖缺失错误 #

creating build\lib.win-amd64-cpython-311\gala\potential\src
      copying gala\potential\src\funcdefs.h -> build\lib.win-amd64-cpython-311\gala\potential\src
      creating build\lib.win-amd64-cpython-311\gala\tests
      copying gala\tests\__init__.py -> build\lib.win-amd64-cpython-311\gala\tests
      copying gala\tests\optional_deps.py -> build\lib.win-amd64-cpython-311\gala\tests
      copying gala\tests\setup_package.py -> build\lib.win-amd64-cpython-311\gala\tests
      copying gala\tests\test_units.py -> build\lib.win-amd64-cpython-311\gala\tests
      copying gala\tests\test_util.py -> build\lib.win-amd64-cpython-311\gala\tests
      running build_ext
      Compiling gala/cconfig.pyx because it changed.
      [1/1] Cythonizing gala/cconfig.pyx
      building 'gala._cconfig' extension
      error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/
      [end of output]

  note: This error originates from a subprocess, and is likely not a problem with pip.
  ERROR: Failed building wheel for gala
Failed to build gala
ERROR: Could not build wheels for gala, which is required to install pyproject.toml-based projects

Setuptools配置警告（中文翻译） #

############################

包将被忽略 #

############################
Python 将 'gala.tests' 识别为可导入包^1，但它未出现在setuptools的packages配置中。

这会导致配置模糊。如果你想分发这个包，请确保将'gala.tests'显式添加到packages配置字段中。

或者，你也可以依赖setuptools的发现方法（例如使用find_namespace_packages(...)/find_namespace:替代find_packages(...)/find:）。

你可以在setuptools文档页面阅读更多关于"包发现"的内容：

• https://setuptools.pypa.io/en/latest/userguide/package_discovery.html

如果你不想分发'gala.tests'，并且已经通过find_namespace_packages(...)/find_namespace或find_packages(...)/find显式排除了'gala.tests'，你可以尝试使用exclude_package_data，或者结合更精细的package-data配置使用include-package-data=False。

你可以在setuptools文档页面阅读更多关于"包数据文件"的内容：

• https://setuptools.pypa.io/en/latest/userguide/datafiles.html

---

解决步骤 #

1. 安装编译依赖 #

错误明确提示需要Microsoft Visual C++ 14.0及以上版本的编译工具，需安装Microsoft C++ Build Tools，安装时勾选「使用C++的桌面开发」组件，确保包含MSVC编译器、Windows SDK等核心组件，完成后重启终端。

2. 创建隔离的Python环境 #

全局环境因升级已混乱，直接降级容易陷入依赖冲突，建议创建全新的适配gala的Python环境：

• 执行命令创建环境：conda create -n gala_env python=3.8.8
• 激活环境：conda activate gala_env

3. 安装gala包 #

在激活的隔离环境中，优先使用conda安装（避免编译问题）：

conda install -c conda-forge gala

若conda安装失败，再使用pip安装（此时编译依赖已准备好）：

pip install gala

4. 处理Setuptools警告 #

该警告属于gala包自身的配置问题，不影响包的正常安装与使用，可直接忽略。若需彻底消除警告，可克隆gala源码，修改setup.py中的packages配置，添加'gala.tests'，或改用find_namespace_packages()替代原有的包发现方式，但一般无需操作。

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