如何在Python包内设置断点，导入本地fork的pandas进行调试

前置准备 #

• 提前创建独立的Python虚拟环境，避免影响系统全局Python环境
• 卸载环境中已安装的官方pandas包，执行多次pip uninstall pandas直到提示无对应安装包

方案1：长期开发推荐：可编辑模式安装 #

该方案下修改本地pandas代码后无需重新安装，导入时自动加载最新代码，适配日常开发调试场景

1. 进入你fork到本地的pandas仓库根目录
2. 先安装开发依赖：pip install -r requirements-dev.txt
3. 执行可编辑安装：pip install -e .

该命令会将本地pandas目录链接到Python库搜索路径，后续导入的pandas均为本地开发版本

方案2：临时测试用：动态修改导入路径 #

无需安装，仅在当前运行的脚本中生效，适合快速验证单场景逻辑
在脚本最开头加入如下代码：

import sys
# 替换为你本地pandas仓库的根目录绝对路径
sys.path.insert(0, "/path/to/your/local/pandas/repo")
import pandas as pd

注意sys.path.insert要放在import pandas之前，且路径优先级高于系统默认库路径，保证优先加载本地版本

验证导入是否正确 #

执行如下代码，输出的文件路径如果是你本地pandas仓库路径即为配置成功：

import pandas as pd
print(pd.__file__)

断点调试方案 #

内置pdb调试（无IDE场景） #

• 静态断点：直接在你想要调试的pandas源码对应位置加入import pdb; pdb.set_trace()，运行调用对应函数的脚本时会自动停在断点位置
• 动态断点：执行脚本时使用python -m pdb your_test_script.py启动，进入pdb交互界面后用b 源码相对路径:行号的方式设置断点，比如b pandas/core/frame.py:100就是在DataFrame类定义的对应行打断点

IDE调试 #

• PyCharm：打开本地pandas仓库目录，右键点击目录选择「Mark Directory as -> Sources Root」，之后直接在pandas源码对应行打普通断点即可正常进入
• VSCode：在.vscode/launch.json中添加配置项"justMyCode": false，关闭仅调试用户代码的限制，即可直接在pandas源码中打断点调试

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