使用Poetry管理的Python项目如何在Visual Studio Code中调试？

步骤1：指定项目对应的Poetry虚拟环境 #

按Ctrl+Shift+P调出VS Code命令面板，搜索「Python: 选择解释器」，在列表中选中当前项目对应的Poetry虚拟环境的Python可执行文件。

步骤2：创建并配置.vscode/launch.json #

在项目根目录下创建.vscode文件夹，在文件夹内新建launch.json文件，填入以下配置即可：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "调试Poetry项目",
            "type": "python",
            "request": "launch",
            "module": "my_project.my_project",
            "cwd": "${workspaceFolder}",
            "justMyCode": true
        }
    ]
}

该配置以模块方式启动项目，等价于执行python -m my_project.my_project，会自动将项目根目录加入Python搜索路径，可正确识别包结构，相对导入不会报错，运行逻辑和你使用poetry run my-project完全一致。

如果希望直接调用Poetry生成的入口脚本调试，可以使用以下配置（Windows用户需将program路径改为${workspaceFolder}/.venv/Scripts/my-project.exe）：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "调试Poetry入口脚本",
            "type": "python",
            "request": "launch",
            "program": "${workspaceFolder}/.venv/bin/my-project",
            "cwd": "${workspaceFolder}",
            "justMyCode": true
        }
    ]
}

配置完成后，在VS Code运行面板选中对应配置，按F5即可正常断点调试。

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