VS Code调试器触发FileNotFoundError：找不到uv的python312.zip文件

调试Python代码时突然触发错误：

FileNotFoundError: [WinError 2] The system cannot find the file specified: path-to-uv/uv/python312.zip

连续4次克隆仓库后调试仍无法正常运行，暂未在网上找到对应解决方案。此前相同配置已稳定运行数月，近期启动调试时，终端会正常激活虚拟环境、进入工作区、运行debugpy启动器，但随后因上述错误冻结。重新克隆仓库可临时恢复，但希望找到更彻底的解决办法。

环境配置 #

• 操作系统：Microsoft Windows 11 Version 25h2 (OS Build 26200.7462)
• VS Code版本：1.107.0 (system setup)
• git版本：2.49.0.windows.1
• uv版本：0.9.7 (0adb44480 2025-10-30)
• Python版本：3.12.12（通过uv安装）

调试配置 #

launch.json内容 #

{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        { //Hint my debug setup name
            "name": "My debug setup name",
            "type": "debugpy",
            "request": "launch",
            "program": "${workspaceFolder}/main.py",
            "console": "integratedTerminal",
            "envFile": ".env",
            "args": [
                "--param1",
                "arg1",
                "--param2",
                "arg2",
                "--flag-param"
            ],
            "env": {
                "env_var1": "env_var1_value",
                "env_var2": "env_var2_value",
            },
            "justMyCode": false,
            "python": "${command:python.interpreterPath}"
        },
    ]
}

断点设置 #

• 抛出的异常（Raised Exceptions）
• 未捕获的异常（Uncaught Exceptions）
• 用户代码未捕获的异常（User Uncaught Exceptions）

错误调用栈 #

mtime (path-to-uv\uv\python\cpython-3.12.12-windows-x86_64-none\Lib\importlib\metadata\__init__.py:698)
search (path-to-uv\uv\python\cpython-3.12.12-windows-x86_64-none\Lib\importlib\metadata\__init__.py:693)
<genexpr> (path-to-uv\uv\python\cpython-3.12.12-windows-x86_64-none\Lib\importlib\metadata\__init__.py:795)
_run_code (path-to-uv\uv\python\cpython-3.12.12-windows-x86_64-none\Lib\runpy.py:88)
_run_module_as_main (path-to-uv\uv\python\cpython-3.12.12-windows-x86_64-none\Lib\runpy.py:198)

已尝试的操作 #

• 将main.py替换为Hello World程序，调试仍报错
• 修改launch.json中的配置参数，无效
• 重新克隆仓库可临时解决问题，但无法根治

内容的提问来源于stack exchange，提问作者Илиян Илиев