调试Python脚本触发AssertionError: group参数必须为None问题求助

问题根源 #

从错误栈可定位：VS Code调试依赖的debugpy内置pydevd库，调用threading.start_new_thread时传递了非None的group参数，而Python 3.12的threading.Thread构造函数严格校验该参数必须为None，触发断言错误。此问题属于调试工具与Python版本的兼容性问题，和业务代码无关——哪怕极简循环打印代码也会触发。

排查步骤 #

• 确认VS Code Python插件版本：你当前使用的ms-python.debugpy-2024.6.0对Python 3.12的适配存在缺陷
• 验证Python版本：确认环境为Python 3.12，低版本（如3.11）的threading模块虽有同样断言，但旧版pydevd已适配
• 排除第三方库干扰：重装Python后问题依旧，说明不是第三方库修改threading模块导致的问题

解决方案 #

• 更新VS Code Python插件：打开VS Code扩展市场，找到Python插件更新到最新版本。微软会持续迭代debugpy适配新Python版本，新版本大概率修复该兼容性问题
• 降级Python版本：若暂时无法更新插件，可将Python版本降级到3.11，该版本与你当前使用的debugpy-2024.6.0兼容性更好
• 手动替换适配的pydevd：找到插件安装目录（c:\Users\Stas\.vscode\extensions\ms-python.debugpy-2024.6.0-win32-x64\bundled\libs\debugpy\_vendored\pydevd），替换为支持Python 3.12的pydevd版本（此方法较复杂，优先推荐前两种）

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