Poetry新建项目生成pyproject.toml时Python版本不符问题咨询

我通过pyenv指定了全局Python版本为3.10.9：

pyenv global 3.10.9
python --version
Python 3.10.9

同时Poetry的配置也设置了优先使用当前激活的Python版本：

(base) bob@Roberts-Mac-mini shims % poetry config --list (amended)
virtualenvs.create = true
virtualenvs.in-project = true
virtualenvs.prefer-active-python = true

但执行poetry new --src newproject创建新项目后，生成的pyproject.toml里Python版本却被设为3.11（也就是我当初安装Poetry时使用的版本）：

[tool.poetry]
name = "newproject"
version = "0.1.0"
description = ""
authors = ["XXXX YYYYYY <ZZZZZZZZZZ@gmail.com>"]
readme = "README.md"
packages = [{include = "newproject", from = "src"}]

[tool.poetry.dependencies]
python = "^3.11"

[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"

我有三个疑问：

1. 这项virtualenvs.prefer-active-python的实验性配置有没有潜在问题？
2. 手动编辑pyproject.toml把Python版本改成3.10，再执行poetry env use 3.10创建对应虚拟环境，这个方法可行吗？
3. 还有其他能强制新项目使用Python 3.10.9的解决方案吗？

1. 实验性配置virtualenvs.prefer-active-python的潜在问题 #

• 既然是实验性配置，就意味着它还没经过足够多的生产场景验证，后续Poetry版本可能会调整它的逻辑，甚至直接移除该配置，现在依赖它的话，未来版本升级可能会出现兼容性问题。
• 存在优先级冲突风险：如果Poetry检测到本地已有符合项目依赖的虚拟环境，可能会跳过当前激活的Python版本，直接复用旧环境，导致预期外的结果。
• 跨平台表现可能不一致：结合pyenv这类版本管理工具时，在Windows、Linux、macOS上的行为可能存在差异，容易出现环境不匹配的情况。

2. 手动修改配置再指定环境的可行性 #

这个方法完全可行，具体步骤：

1. 打开pyproject.toml，把python = "^3.11"改成python = "^3.10"（如果要精确锁定版本，可以写成~3.10.9）
2. 执行poetry env use 3.10.9，明确指定要使用的Python版本
3. 运行poetry install，Poetry会自动创建基于Python 3.10.9的虚拟环境并安装依赖

注意：修改版本约束前，要确认项目依赖的第三方包都支持Python 3.10.9，避免后续安装依赖时出现兼容性报错。

3. 其他强制使用Python 3.10.9的方案 #

• 创建项目时直接指定版本：执行poetry new --src newproject --python 3.10.9，新建项目时直接指定目标Python版本，生成的pyproject.toml会自动写入python = "^3.10.9"的约束，同时Poetry会自动匹配对应版本创建虚拟环境。
• 全局配置Poetry默认Python版本：运行poetry config virtualenvs.python 3.10.9，全局设置Poetry创建虚拟环境的默认Python版本，后续新建项目都会沿用这个配置（除非项目单独指定版本）。
• 确保pyenv环境完全生效：创建项目前，先执行pyenv shell 3.10.9（仅对当前会话生效），再运行poetry new命令，确保当前Shell的Python环境完全是3.10.9，避免pyenv全局配置未正确加载的问题。

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