### 如何在 PyCharm 中配置并使用 Poetry 管理的 Python 虚拟环境 要在 PyCharm 中配置并使用由 Poetry 创建的 Python 虚拟环境作为解释器，可以按照以下方法操作： #### 配置 Poetry 环境 1. **确保已安装 Poetry** 如果尚未安装 Poetry，可以通过 Windows 安装命令完成安装： ```powershell (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py - ``` 此命令会下载并执行 Poetry 的安装程序[^3]。 2. **初始化项目并创建虚拟环境** 使用 Poetry 初始化一个新的 Python 项目，并自动创建虚拟环境： ```bash poetry init poetry install ``` 运行以上命令后，Poetry 将会在当前目录下生成 `pyproject.toml` 文件，并基于该文件的内容创建一个隔离的虚拟环境[^3]。 3. **定位 Poetry 虚拟环境路径** Poetry 默认会在用户的缓存目录中存储虚拟环境。通过以下命令查看具体路径： ```bash poetry env info -p ``` 输出的结果将是虚拟环境的具体位置，例如：`C:\Users\<用户名>\AppData\Local\Pypoetry\Cache\virtualenvs\<项目名>-<哈希值>`[^3]。 #### 在 PyCharm 中配置 Poetry 解释器 1. 打开 PyCharm 并进入项目的设置界面： 在标题栏依次选择 `File → Settings → Project: <项目名称> → Python Interpreter`[^2]。 2. 添加新的解释器： 点击右上角的齿轮图标，选择 `Add...`，然后在弹出窗口中选择 `Poetry Environment` 选项卡。如果未检测到 Poetry，则需要手动指定其可执行文件的位置（通常位于系统的 PATH 环境变量中）。 3. 自动识别或手动输入虚拟环境路径： 若 PyCharm 成功找到 Poetry 环境，则可以直接加载；否则需手动填写之前获取的虚拟环境路径（如前所述，可通过 `poetry env info -p` 获取）。 4. 应用更改并验证： 设置完成后，点击 `Apply` 和 `OK` 按钮保存修改。此时，在 PyCharm 的终端中运行 `python --version` 或者尝试导入模块时，应该能够确认正在使用的正是 Poetry 管理下的虚拟环境中的解释器及其依赖项。 ```python import sys print(sys.executable) ``` 此代码片段可用于打印当前所用 Python 可执行文件的实际路径，进一步验证是否正确指向了 Poetry 创建的虚拟环境。 --- ### 注意事项 - 当切换至其他分支或者更新依赖关系表 (`pyproject.toml`) 后，可能需要重新同步 Poetry 环境以反映最新变化。 - 如果遇到权限问题或其他异常情况，请检查操作系统对于目标目录的操作许可权设定。 ---