VS Code Python 扩展提示无环境安装 uv 后的终端输出解读与配置

1. 发生了什么？

点击'确定'时，VS Code 在后台下载并安装了 uv 工具。

• uv 是什么？ 一个用 Rust 语言编写的快速 Python 包和项目管理工具，可视为 pip 和 virtualenv 的增强版。
• 为什么推荐它？ 当电脑未安装 Python 时，uv 可帮助方便地安装不同版本的 Python。

2. 终端输出解读

• installing to C:\Users\Administrator\.local\bin 文件安装到用户目录下的隐藏文件夹 .local/bin。
• uv.exe uvx.exe uvw.exe 安装的可执行文件。
• everything's installed! 安装成功。
• To add ... to your PATH... 关键问题：uv 所在文件夹不在系统环境变量 PATH 中。新命令行窗口输入 uv 可能无法识别。

3. 解决方案

方法一：重启 VS Code（推荐）

输出建议：'either restart your shell'。最简单的方法是关闭 VS Code 并重新打开。启动时会重新读取系统环境变量，可能自动识别 uv。

方法二：手动添加 PATH

若重启无效，需手动将安装路径添加到环境变量。

CMD：

set Path=C:\Users\Administrator\.local\bin;%Path%

注意：仅当前窗口有效。

PowerShell：

$env:Path = "C:\Users\Administrator\.local\bin;$env:Path"

注意：仅当前会话有效。永久生效需在系统设置中修改。

总结

1. VS Code 安装了 uv 工具用于管理 Python。
2. 安装成功后需确保路径在系统 PATH 中以便使用命令。
3. 新手建议直接重启 VS Code；进阶操作可手动配置环境变量。

解决此问题后，即可使用 uv 安装 Python 版本。