如何在VSCode中调试Python CLI程序（以Poetry为例）

一、先明确Poetry的入口点 #

Poetry的CLI入口是poetry.__main__模块，平时用的poetry add其实等价于python -m poetry add，直接通过模块方式启动就能对接调试工具。

二、VSCode调试配置步骤 #

• 打开VSCode调试面板（Ctrl+Shift+D），点击「创建launch.json文件」，选择Python环境
• 把launch.json替换成以下配置，注意将args换成你出问题的具体命令（比如报错的add source相关参数）：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Poetry Debug",
            "type": "python",
            "request": "launch",
            "module": "poetry",
            "args": ["add", "source", "test-source", "--url", "https://your-repo-url.com"],
            "justMyCode": false, // 必须开启，否则无法进入Poetry源码调试
            "env": { // 可选：若遇证书问题，可在这里添加证书路径环境变量
                "REQUESTS_CA_BUNDLE": "C:/path/to/your/cert.pem"
            }
        }
    ]
}

• 在Poetry源码里对应逻辑处设断点：比如poetry/console/application.py的run方法，或者poetry/commands/add.py里的命令处理代码
• 点击调试启动按钮，程序会在断点处暂停，即可逐步排查问题

三、手动脚本调试（VSCode配置卡壳时备用） #

写一个简单的Python脚本，直接调用Poetry的入口函数：

import sys
from poetry.__main__ import main

# 替换成你要调试的命令参数
sys.argv = ["poetry", "add", "source", "test-source", "--url", "https://your-repo-url.com"]
main()

• 在VSCode里直接运行这个脚本，记得开启justMyCode: false，同样可以断点调试

四、针对性调试技巧 #

• 证书错误：跟踪requests库的证书加载逻辑，或查看Poetry封装的请求工具（比如poetry/utils/requests.py）
• "is a directory"错误：重点排查路径处理代码，比如poetry/utils/path.py里的路径解析方法，或add命令中处理源路径/URL的逻辑

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