在 VS Code 中首次配置 Python 环境时,常会遇到提示'没有 Python 环境'的情况。点击左侧活动栏的蟒蛇图标后,编辑器会询问是否安装 uv 来管理版本。

选择确定后,终端窗口会滚动一段英文日志,最后显示类似这样的内容:
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)
面对这段输出,新手往往容易不知所措。其实它只传达了两层核心信息:工具已安装成功,但环境变量尚未生效。
理解终端日志的含义
当我们点击确认时,VS Code 实际上在后台下载并安装了 uv 工具。这是一个用 Rust 编写的高性能 Python 包和项目管理工具,可以理解为 pip 和虚拟环境的超级加强版。
日志中的关键部分如下:
installing to C:\Users\Administrator\.local\bin表示文件被解压到了用户目录下的隐藏文件夹中。这是 Windows 上常见的工具存放位置。uv.exe uvx.exe uvw.exe这三个可执行文件已成功生成,标志着安装过程完成。everything's installed!确认安装无误。To add ... to your PATH...这是最关键的部分。虽然文件装好了,但系统还不知道它们在哪。PATH 环境变量相当于系统的'寻人启事列表',只有将uv所在的路径加入其中,命令行才能识别该命令。
解决方案
别被那一长串代码吓到,VS Code 已经给出了两种修复路径,二选一即可。
方案一:重启 IDE(推荐)
对于大多数初学者,最简单的方法是直接关闭 VS Code 再重新打开。
原理:IDE 启动时会读取一次系统的环境变量。既然刚才修改了系统配置(尽管系统可能还没刷新),重启可以让 VS Code 重新加载最新的环境变量,从而识别出 uv 命令。
操作:
- 完全退出 VS Code。
- 重新双击图标启动。
- 再次点击蟒蛇图标,检查报错是否消失。
如果问题依旧,或者你想在任何终端窗口都能使用 uv,请尝试下面的手动方法。
方案二:手动添加环境变量
如果你希望永久生效,需要按照屏幕提示手动配置。
CMD 用户 复制以下命令在当前窗口运行:
set Path=C:\Users\Administrator\.local\bin;%Path%
注意:这仅对当前 CMD 窗口有效,关闭窗口即失效。
PowerShell 用户 VS Code 默认终端通常是 PowerShell,运行以下命令:



