如何在VSCode中调试通过exec()执行的Python代码？

我明白你的痛点——用exec()执行字符串形式的插件代码时，VSCode调试器没法直接单步进入，确实很头疼。核心问题在于调试器需要关联真实的源码文件路径才能识别断点和执行位置，而exec()直接跑字符串的话，调试器找不到对应的“源码文件”信息。

给你几个可行的方案，按推荐程度排序：

方案1：直接动态导入脚本文件（最推荐） #

既然你的插件脚本本来就是文件形式，完全没必要先读成字符串再exec()，直接动态导入这个脚本文件就行，调试器能完美识别原文件的代码：

比如假设你的插件脚本路径是./plugins/custom_script.py，可以用importlib来动态导入：

import importlib.machinery
import os

# 假设这是你拿到的插件脚本路径
script_path = "./plugins/custom_script.py"
# 获取脚本所在目录和文件名
script_dir, script_name = os.path.split(script_path)
module_name = os.path.splitext(script_name)[0]

# 动态加载脚本模块
loader = importlib.machinery.SourceFileLoader(module_name, script_path)
plugin_module = loader.load_module()

# 如果脚本里有需要执行的逻辑（比如入口函数），直接调用
# 比如假设脚本里有run()函数：
# plugin_module.run()

这样你直接在VSCode里打开custom_script.py，设置断点，运行主程序时就能直接单步进入插件脚本的代码了，完全和调试普通Python文件一样。

方案2：给exec()添加源码路径信息（适配字符串场景） #

如果因为某些原因必须用exec()执行字符串代码（比如你确实需要动态生成代码字符串），可以给exec()指定__file__参数，让调试器知道这段代码对应的“虚拟文件”路径，同时把代码先写入临时文件，让调试器能关联上：

import tempfile
import os

# 这里是你从文件读取的代码字符串
code = '''
for x in range(0,100):
    print("Hello %d" % x)
'''

# 创建临时文件保存代码（和原插件文件同名更好，方便识别）
temp_file_path = "./temp_plugin.py"  # 或者用tempfile模块生成临时路径
with open(temp_file_path, 'w', encoding='utf-8') as f:
    f.write(code)

# 给exec指定globals参数，加入__file__和__name__，让调试器关联临时文件
globals_dict = {
    '__file__': temp_file_path,
    '__name__': '__main__',
    # 可以把主程序需要传递给插件的变量也加在这里
}

# 执行代码，此时调试器能关联到temp_file_path的内容
exec(code, globals_dict)

# 用完可以删除临时文件（可选）
# os.unlink(temp_file_path)

然后你打开这个临时文件（或者原插件文件，如果临时文件和原文件内容一致），设置断点，运行主程序时就能单步进入这段代码了。

方案3：用pdb手动指定源码（应急用） #

如果临时需要调试，也可以在主程序里调用pdb，手动加载源码文件：

import pdb

# 你的插件代码文件路径
script_path = "./custom_script.py"
# 先执行一次导入或者exec，然后启动pdb
exec(open(script_path).read())
pdb.set_trace()

进入pdb后，用source script_path加载源码，然后就能设置断点调试了，但这种方式不如前两种方便，适合临时排查问题。

另外，如果你实在不想用VSCode，PyCharm对动态执行的代码调试支持也比VSCode好一点，但方案1在所有IDE里都能完美工作，推荐优先用方案1。

备注：内容来源于stack exchange，提问作者user3696153