Python Poetry异常指向无效envs.toml而非项目pyproject.toml如何修复？

问题原因 #

Poetry启动时会自动读取缓存目录下的envs.toml，这个文件用来记录各个项目与虚拟环境的关联关系，并非突然“指向”它——只是之前这个文件语法正常，现在出现了格式错误（第5行的]不符合TOML语法规范），导致Poetry启动失败，根本没走到读取项目pyproject.toml的步骤。

修复步骤 #

• 先备份出错的文件：复制C:/Users/username/AppData/Local/pypoetry/Cache/virtualenvs/envs.toml到其他位置，避免误操作丢失配置
• 修复或删除envs.toml：
  • 如果你能看懂TOML语法，打开文件找到第5行的]，检查上下文（比如是不是数组括号没配对、表名格式错误），修正后保存
  • 要是对TOML不熟悉，直接删除这个文件即可——Poetry会在下次运行时自动重建一个新的envs.toml
• 回到项目根目录，重新执行poetry add xxx，此时Poetry会正常加载项目的pyproject.toml

额外排查方案 #

如果删除文件后仍有问题：

• 清除Poetry的缓存：执行poetry cache clear --all pypi
• 重建项目虚拟环境：先执行poetry env remove python删除现有虚拟环境，再运行poetry install重新创建并安装依赖

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