VS Code安装Python扩展报错：end of central directory record signature not found

问题说明 #

安装VS Code的Python扩展时，自动安装或手动安装均触发以下错误：

Error while installing 'Python' extension. Please check the [log](command:workbench.action.showWindowLog) for more details.
日志中显示核心错误：
[error] end of central directory record signature not found,end of central directory record signature not found: Error: end of central directory record signature not found,end of central directory record signature not found

解决步骤 #

• 清理扩展缓存

  1. 彻底关闭VS Code（包括后台运行的进程）
  2. 定位到扩展缓存目录：
     • Windows：%USERPROFILE%\.vscode\extensions\.cache
     • macOS/Linux：~/.vscode/extensions/.cache
  3. 删除该目录下所有文件，重启VS Code后重新尝试安装

• 重新下载并校验扩展包

  1. 手动下载Python扩展的最新.vsix安装包
  2. 对比官方提供的校验值（MD5/SHA256），确认文件未损坏
  3. 在VS Code中按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），执行命令Extensions: Install from VSIX...，选择下载好的文件完成安装

• 临时关闭签名验证

  1. 打开VS Code设置，搜索extensions.verifySignature
  2. 将该选项设置为false，重启VS Code后尝试安装，安装完成后可改回默认值

• 手动解压安装

  1. 使用可靠的解压工具（如7-Zip）将.vsix文件解压到VS Code的extensions目录：
     • Windows：%USERPROFILE%\.vscode\extensions
     • macOS/Linux：~/.vscode/extensions
  2. 确保解压后的文件夹名称符合扩展命名规范（一般为ms-python.python-版本号），重启VS Code即可

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