如何在VSCode 1.91.1中恢复兼容的旧版debugpy扩展？

方法1：单独安装兼容版本的debugpy扩展 #

• 打开VSCode扩展面板（快捷键Ctrl+Shift+X），搜索debugpy（发布者为Microsoft的ms-python.debugpy）
• 找到扩展后，点击右下角的设置图标，选择「Install Another Version...」
• 在弹出的版本列表中，选择2024.9.0及更早版本（2024.10.0版本开始要求VSCode 1.92.0+），等待安装完成
• 安装后再次点击设置图标，选择「Disable Auto-Updates」，避免扩展自动升级回不兼容版本

方法2：在Dev Container配置中固定扩展版本 #

如果是通过Dev Container启动开发环境，直接在.devcontainer/devcontainer.json中指定兼容的扩展版本，确保每次构建都安装对应版本：

"extensions": [
    "ms-python.debugpy@2024.9.0",
    "ms-python.python@2024.9.0" // 建议同步Python主扩展到对应兼容版本
]

• 保存配置后，重新构建Dev Container，环境会自动安装指定版本的扩展，不会触发自动升级

方法3：手动替换扩展文件（应急方案） #

• 先完全关闭VSCode和Dev Container环境
• 进入WSL2的扩展目录，执行命令删除自动生成的不兼容版本：

  rm -rf /root/.vscode-server/extensions/ms-python.debugpy-2024.10.0-linux-x64
  

• 从本地Windows的VSCode扩展缓存中找到兼容版本的debugpy（路径一般为C:\Users\<你的用户名>\.vscode\extensions\ms-python.debugpy-<兼容版本号>-win32-x64），将整个文件夹复制到WSL2的/root/.vscode-server/extensions/目录下
• 重启VSCode并打开Dev Container，此时会加载你复制的旧版本扩展

注意事项 #

• 检查全局VSCode设置，确保没有开启「Extensions: Auto Update」全局自动更新，或单独禁用debugpy和Python扩展的自动更新
• 若之前修改过工作区或项目的settings.json，移除任何强制指定扩展版本为最新的配置

内容的提问来源于stack exchange，提问作者H.Sheng