Debian如何配置Python调试工具

下面按从基础到进阶的方式，说明在 Debian 上配置 Python 调试工具 的常见做法，适用于 Debian 11/12（bullseye / bookworm）。

一、基础环境准备

1. 安装 Python 与开发工具

Debian 默认已带 Python，但建议安装完整开发环境：

sudo apt update
sudo apt install -y python3 python3-pip python3-venv python3-dev

2. 创建虚拟环境（强烈推荐）

避免污染系统 Python：

python3 -m venv venv
source venv/bin/activate

二、常用 Python 调试工具及配置

✅ 1. pdb（Python 内置调试器）

安装

无需安装，Python 自带。

使用方式

方式一：命令行启动

python3 -m pdb script.py

方式二：代码中插入断点

import pdb
pdb.set_trace()

方式三（Python 3.7+）

breakpoint()

常用命令

命令	说明
n	下一行
s	进入函数
c	继续执行
l	查看代码
p x	打印变量
q	退出

✅ 2. 安装增强调试工具（推荐）

1️⃣ ipdb（增强版 pdb）

支持自动补全、语法高亮：

pip install ipdb

使用：

import ipdb
ipdb.set_trace()

或：

python3 -m ipdb script.py

2️⃣ pudb（图形化终端调试器）

类似 Turbo C 的界面，非常适合初学者。

pip install pudb

运行：

pudb3 script.py

快捷键：

n 下一步
s 进入函数
b 设置断点
q 退出

三、IDE / 编辑器调试配置

✅ 1. VS Code（最常用）

安装插件

Python（Microsoft 官方）

配置调试

打开项目
按 Ctrl + Shift + D
创建 launch.json

示例：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: 当前文件",
      "type": "python",
      "request": "launch",
      "program": "${file}",
      "justMyCode": false
    }
  ]
}

✅ 支持：

断点
变量查看
单步调试
远程调试

✅ 2. PyCharm

社区版免费
直接支持图形化调试
无需额外配置

四、远程 / 服务器调试（Debian 服务器常用）

1. 使用 debugpy（VS Code 远程调试）

pip install debugpy

启动脚本：

import debugpy
debugpy.listen(("0.0.0.0", 5678))
debugpy.wait_for_client()

VS Code 配置：

{
  "type": "python",
  "request": "attach",
  "connect": {
    "host": "服务器IP",
    "port": 5678
  }
}

五、日志调试（生产环境推荐）

使用 logging 替代 print

import logging
logging.basicConfig(level=logging.DEBUG)

logging.debug("调试信息")
logging.info("运行信息")

六、Debian 常见问题

1. pip 安装的包找不到？

使用虚拟环境或：

python3 -m pip install xxx

2. 系统 Python 被误改？

✅ 不要修改 /usr/bin/python3 ✅ 使用 venv 或 conda

七、推荐组合（总结）

场景	推荐
快速调试	pdb / ipdb
可视化调试	pudb
本地开发	VS Code
服务器调试	debugpy
生产问题	logging

如果你愿意，可以告诉我：

是 本地 Debian 桌面 还是 远程服务器
使用 VS Code / PyCharm / 纯终端
调试 Web（Flask/Django）还是脚本

我可以给你一份完全定制的调试配置方案。