PyInstaller打包my_plugin后，如何修改VSCode launch.json实现客户插件调试

你遇到的ValueError: source code string cannot contain null bytes错误，本质是PyInstaller打包出的EXE是二进制编译产物，内部包含空字节，而VSCode依赖的Python调试器（如debugpy）需要解析可读的纯文本源码，直接加载EXE会导致源码解析失败。

以下是几个可行的配置方案，帮客户顺利调试自定义插件：

方案1：拆分模块，保留纯Python调试入口 #

把my_plugin中需要隐藏的核心逻辑单独编译成二进制扩展（比如用Cython转成.pyd文件），而保留host.py作为纯Python的调试入口文件：

• 调整my_plugin的目录结构：

  my_plugin/
  ├── host.py       # 纯Python入口，仅负责调用核心模块
  └── core/
      ├── __init__.py
      └── core_logic.pyx  # 核心业务逻辑，用Cython编译
  

• host.py里只需简单导入并调用核心模块的功能，无需包含敏感代码
• 客户调试other_plugin时，launch.json依然指向host.py，调试器能正常解析纯Python源码，同时核心逻辑被隐藏

方案2：PyInstaller调试模式+源码映射 #

如果必须用PyInstaller打包整个my_plugin，打包时添加调试参数生成带调试信息的EXE，再通过VSCode的源码映射配置关联到原代码：

1. 打包时执行：

   pyinstaller --debug=all --source-map my_plugin/host.py
   

2. 修改VSCode的launch.json，配置源码映射：

   {
       "version": "0.2.0",
       "configurations": [
           {
               "name": "Debug other_plugin",
               "type": "python",
               "request": "launch",
               "program": "${workspaceFolder}/dist/host.exe",
               "sourceFileMap": {
                   "<embedded>": "${workspaceFolder}/my_plugin"
               },
               "args": ["--your-plugin-args"],
               "env": {"PYTHONPATH": "${workspaceFolder}/other_plugin"}
           }
       ]
   }
   

   这个配置让调试器把EXE内部的嵌入路径映射到真实的源码目录，绕过空字节解析问题。

方案3：提供双版本插件 #

发布两个版本的my_plugin：

• 调试版：仅把核心逻辑编译为.pyd，保留host.py等入口文件为源码，供客户调试时安装
• 生产版：用PyInstaller打包成完整EXE，供上线部署使用
• 可以通过pip的 extras 区分版本：

  # 安装调试版
  pip install my_plugin[debug]
  # 安装生产版
  pip install my_plugin
  

• 绝对不要让调试器直接加载PyInstaller打包的纯EXE，这是触发空字节错误的根本原因
• 调试时确保other_plugin的路径被加入PYTHONPATH，避免模块导入错误
• 用Cython编译核心代码时，记得添加-g参数保留调试信息，方便调试时映射到原代码

内容的提问来源于stack exchange，提问作者Philly G