Hatch创建环境报Python版本不匹配 如何指定使用Python3.9.x

报错根因 #

Hatch创建虚拟环境默认优先使用自身运行依赖的Python解释器，不会直接调用系统默认python3指向的版本。当前本机安装的Hatch运行在Python 3.10.5环境下，创建项目环境时默认拉取3.10版本，与pyproject.toml中配置的>=3.9,<3.10版本限制冲突，触发报错。

解决方法 #

方法1：创建环境时显式指定Python 3.9路径 #

• 先查询Homebrew安装的Python 3.9的绝对路径，执行命令：

  which python3.9
  

  通常Apple Silicon芯片Mac返回路径为/opt/homebrew/bin/python3.9，Intel芯片Mac返回路径为/usr/local/bin/python3.9。
• 创建环境时附加--python参数指定解释器路径，将命令中的路径替换为上一步查到的实际路径：

  hatch env create --python /opt/homebrew/bin/python3.9
  

方法2：项目配置固定Python版本（一劳永逸） #

直接在项目根目录的pyproject.toml中添加Hatch默认环境的Python版本配置，后续所有环境操作都会自动使用3.9版本，无需每次附加参数：

[tool.hatch.envs.default]
python = "3.9"

保存配置后直接执行hatch env create即可正常创建符合版本要求的环境。

验证结果 #

环境创建完成后执行以下命令，若返回Python 3.9.x字样说明配置生效：

hatch run python --version

补充排查：如果执行上述操作仍有异常，可以运行hatch python find列出所有Hatch能识别到的Python解释器，确认Python 3.9在识别列表内即可。

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