问题描述
在 VS Code 中安装 Python 扩展后，点击左侧活动栏的蟒蛇图标，若未检测到 Python 环境，会弹出提示询问是否安装 uv 来管理 Python 版本。确认安装后，终端窗口会输出安装日志。
终端输出解读
安装日志通常如下所示：
installing to C:\Users\Administrator\.local\bin uv.exe uvx.exe uvw.exe everything's installed! To add C:\Users\Administrator\.local\bin to your PATH, either restart your shell or run: set Path=C:\Users\Administrator\.local\bin;%Path% (cmd) $env:Path = "C:\Users\Administrator\.local\bin;$env:Path" (powershell)
关键信息解读：
- 安装位置：文件已安装至
C:\Users\Administrator\.local\bin。 - 状态：
everything's installed!表示安装成功。 - 环境变量：
To add ... to your PATH提示该路径尚未加入系统环境变量 PATH。这意味着在当前命令行输入uv可能无法识别，因为系统不知道去哪里查找该程序。
解决方案
方法一：重启 VS Code（推荐）
VS Code 启动时会读取系统环境变量。直接关闭并重新打开 VS Code，通常能让其自动识别新安装的工具路径。
- 关闭 VS Code。
- 重新打开 VS Code。
- 再次点击蟒蛇图标检查是否报错。
方法二：手动添加环境变量
若重启无效，需手动将安装路径添加到系统 PATH 变量中。 CMD 命令：
set Path=C:\Users\Administrator\.local\bin;%Path%
注意：此方式仅对当前窗口有效，永久生效需在系统设置中修改。
PowerShell 命令：
$env:Path = "C:\Users\Administrator\.local\bin;$env:Path"
注意：此方式仅对当前会话有效。
总结
- VS Code 安装了
uv工具用于管理 Python 环境。 - 终端提示安装成功但未配置 PATH 环境变量。
- 通过重启 VS Code 或手动添加路径至系统环境变量即可解决
uv命令不可用的问题。
