coredumpy与VSCode扩展完美结合：可视化调试崩溃现场的完整指南

虞熠蝶

341人浏览 · 2026-07-05 09:31:20

虞熠蝶 · 2026-07-05 09:31:20 发布

coredumpy与VSCode扩展完美结合：可视化调试崩溃现场的完整指南

【免费下载链接】coredumpy coredumpy saves your crash site for post-mortem debugging 项目地址: https://gitcode.com/gh_mirrors/co/coredumpy

在Python开发过程中，程序崩溃是每个开发者都会遇到的挑战。传统的调试方法往往需要在崩溃发生时立即介入，但有时崩溃发生在生产环境或难以复现的场景中。coredumpy作为一个强大的崩溃现场保存工具，配合VSCode扩展提供了终极的崩溃调试解决方案，让您能够像时间旅行者一样回到程序崩溃的瞬间，可视化地分析崩溃现场。

🔍 什么是coredumpy？

coredumpy是一个专业的Python崩溃现场保存工具，能够在程序崩溃时自动捕获完整的调用栈、变量状态和对象信息，并生成可移植的dump文件。与VSCode扩展完美结合后，它提供了前所未有的可视化调试体验。

核心功能亮点 ✨

一键崩溃现场保存：当程序崩溃时自动生成dump文件
VSCode可视化调试：通过VSCode扩展直接加载和分析dump文件
多框架支持：原生支持unittest、pytest和运行时异常
线程安全：支持多线程程序的崩溃现场捕获
安全可靠：内置敏感信息过滤机制，保护API密钥和环境变量

🚀 快速开始：安装与配置

安装coredumpy

pip install coredumpy

安装VSCode扩展

在VSCode扩展市场中搜索"coredumpy-vscode"并安装，或者直接从Visual Studio Marketplace获取。

📸 coredumpy实战演示

上图展示了coredumpy与VSCode扩展的完美结合效果。当程序崩溃时，coredumpy会自动保存完整的调试信息，然后您可以在VSCode中像调试正常程序一样分析崩溃现场。

🛠️ 如何使用coredumpy保存崩溃现场

方法一：命令行运行（最简单）

# 运行Python脚本并自动保存崩溃现场
coredumpy run my_script.py

# 指定dump文件保存目录
coredumpy run my_script.py --directory ./dumps

# 运行unittest测试套件
coredumpy run -m unittest --directory ./dumps

方法二：pytest插件集成

# 在pytest中使用coredumpy插件
pytest --enable-coredumpy --coredumpy-dir ./dumps

方法三：代码中手动集成

import coredumpy

# 捕获未处理异常
coredumpy.patch_except(directory='./dumps')

# 捕获unittest失败
coredumpy.patch_unittest(directory='./dumps')

# 捕获pytest失败
coredumpy.patch_pytest(directory='./dumps')

🔧 VSCode扩展使用指南

加载dump文件

右键加载：在VSCode资源管理器中右键点击dump文件，选择"Load with coredumpy"
命令行加载：使用coredumpy load <dump_file>启动调试会话
DAP服务器：通过coredumpy host启动调试适配器服务器，支持远程调试

调试功能特性

变量查看器：查看崩溃时的所有局部变量和全局变量
调用栈导航：在崩溃调用栈中自由跳转
对象属性检查：深入查看对象的属性和方法
源代码查看：直接查看崩溃点的源代码
多线程支持：同时查看所有线程的状态

🎯 高级配置与自定义

安全配置

coredumpy内置了敏感信息保护机制，您可以根据需要自定义：

from coredumpy import config
import re

# 自定义API密钥模式
config.secret_patterns.append(re.compile(r"sk-[A-Za-z0-9]{48}"))

# 调整环境变量过滤条件
config.environ_filter = lambda env: len(env) > 12

# 关闭敏感信息过滤（不推荐）
config.hide_secret = False
config.hide_environ = False

性能调优

from coredumpy import config

# 调整默认递归深度（影响dump文件大小）
config.default_recursion_depth = 5

# 设置dump超时时间（秒）
config.dump_timeout = 30

# 是否dump所有线程
config.dump_all_threads = True

📁 项目结构解析

了解coredumpy的项目结构有助于更好地使用和定制：

src/coredumpy/
├── coredumpy.py          # 核心dump/load功能
├── dap_server.py         # VSCode调试适配器服务器
├── except_hook.py        # 异常钩子处理
├── pytest_hook.py        # pytest集成
├── unittest_hook.py      # unittest集成
├── type_support.py       # 自定义类型支持
└── config.py            # 全局配置管理

关键模块说明

coredumpy.py：包含主要的dump和load功能，处理崩溃现场的序列化和反序列化
dap_server.py：实现Debug Adapter Protocol服务器，为VSCode提供调试接口
config.py：集中管理所有配置选项，支持运行时动态调整

🔌 自定义类型支持

coredumpy支持扩展自定义类型的序列化。通过继承coredumpy.TypeSupportBase，您可以添加对任意类型的支持：

import coredumpy

class MyTypeSupport(coredumpy.TypeSupportBase):
    @classmethod
    def get_type(cls):
        return (MyCustomClass, "my_custom_type")
    
    @classmethod
    def dump(cls, obj):
        # 返回可序列化的字典和依赖对象列表
        return {"data": obj.serialize()}, None
    
    @classmethod
    def load(cls, data, objects):
        # 从数据重建对象
        return MyCustomClass.deserialize(data["data"]), None