python3 在vscode 中调试

一、先拿到虚拟环境绝对完整路径（必须先做）

终端执行激活环境，再打印真实路径：

bash

 

运行

 

 

source ollama-ocr-env/bin/activate
# 打印完整绝对路径
which python3
# 或者更稳妥
python3 -c "import sys; print(sys.executable)"

 

输出示例（复制这一整串）：

 

/home/xxx/project/ollama-ocr-env/bin/python3

二、VSCode 手动指定解释器（列表搜不到就用这个）

1. 快捷键 Ctrl+Shift+P 调出命令面板
2. 输入：Python: Select Interpreter 回车
3. 拉到列表最底部，点 Enter interpreter path...
4. 选择 Find... 浏览文件，或者直接粘贴刚才复制的完整路径 /xxx/ollama-ocr-env/bin/python3
5. 确认后左下角状态栏就会显示 ollama-ocr-env 环境

三、永久固定环境（不用每次重新选）

项目文件夹里新建 .vscode/settings.json，写入刚才的绝对路径：

json

 

 

{
    "python.defaultInterpreterPath": "/home/xxx/project/ollama-ocr-env/bin/python3"
}

 

保存后重启 VSCode，自动加载该环境。

四、调试配置 launch.json（对应你运行命令：python3 ocr_service.py）

.vscode/launch.json 完整配置，支持终端交互、和手动运行完全一致：

 

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "调试ocr_service",
            "type": "python",
            "request": "launch",
            "program": "${workspaceFolder}/ocr_service.py",
            "console": "integratedTerminal",
            "cwd": "${workspaceFolder}"
        }
    ]
}

 

 

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Flask OCR Service",
            "type": "debugpy",
            "request": "launch",
            "module": "flask",
            "env": {
                "FLASK_APP": "ocr_service.py",
                "FLASK_ENV": "development",
                "FLASK_DEBUG": "1"
            },
            "args": [
                "run",
                "--no-debugger",
                "--no-reload",
                "--host",
                "0.0.0.0",
                "--port",
                "5000"
            ],
            "jinja": true,
            "justMyCode": false,
            "console": "integratedTerminal"
        },
        {
            "name": "Python: Debug Current File",
            "type": "debugpy",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "justMyCode": false
        }
    ]
}

 

• integratedTerminal：内置终端，支持input()输入
• cwd：工作目录和你手动执行命令一致

五、启动调试

1. 打开 ocr_service.py，代码左侧点击空白处打红色断点
2. 顶部调试下拉框选择「调试 ocr_service」
3. 按 F5 开始调试

六、常见排查

1. 粘贴路径提示找不到文件
    
   检查路径是否复制完整、大小写、文件夹权限：chmod +x ollama-ocr-env/bin/python3
2. 导入 ollama 模块报错
    
   确认左下角解释器是 ollama-ocr-env，不是系统 python
3. 断点灰色无效
    
   重启 VSCode、重新选中解释器、重装 Python 扩展