Debian怎么配置Python调试

在 Debian 系统上配置 Python 调试环境，通常涉及调试工具、IDE/编辑器、调试库以及常见调试方式的配置。下面按常用场景给你一个完整、实用的配置指南。

一、安装 Python 与调试相关工具

1. 安装 Python（Debian 通常自带）

python3 --version

如果没有或版本较低：

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

2. 安装调试相关工具

sudo apt install python3-dbg gdb

python3-dbg 提供带调试符号的 Python（适合底层调试）。

二、使用 pdb 调试（最基础、最通用）

1. 在代码中插入断点

import pdb
pdb.set_trace()

或使用 Python 3.7+：

breakpoint()

2. 运行程序

python3 test.py

常用 pdb 命令

三、使用 VS Code 调试（强烈推荐）

1. 安装 VS Code

sudo apt install code

或通过官网下载 .deb

2. 安装 Python 插件

VS Code → Extensions → 搜索 Python（Microsoft）

3. 配置调试文件

Ctrl + Shift + D → 创建 launch.json

示例配置：

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

点击 ▶ 即可调试（支持断点、变量查看、单步执行）

四、使用 PyCharm（适合专业开发）

1. 安装 PyCharm

sudo snap install pycharm-community --classic

或下载官网版本

2. 配置 Python 解释器

Settings → Python Interpreter → 选择 python3

PyCharm 自带：

• 断点
• 变量监视
• 条件断点
• 远程调试

五、使用 debugpy（远程 / 容器调试）

适合服务器、Docker、远程 Debian 系统。

1. 安装

pip install debugpy

2. 启动调试服务

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

3. VS Code 连接

{
  "type": "python",
  "request": "attach",
  "connect": {
    "host": "远程IP",
    "port": 5678
  }
}

六、调试 Segmentation Fault（底层问题）

1. 使用 gdb

gdb python3
run test.py
bt

或使用：

python3-dbg test.py

七、虚拟环境调试（推荐）

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

VS Code / PyCharm 选择该虚拟环境即可。

八、常见调试场景速查

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

• ✅ 是 桌面 Debian 还是服务器
• ✅ 使用 VS Code / PyCharm / 命令行
• ✅ 调试 普通 Python 还是 C 扩展 / 多进程 / Docker

我可以给你一步到位的具体配置方案。