【从零开始的VS Code Python环境配置：uv】

写在前面

作为一个编程小白，今天心血来潮想要学习Python。本以为安装个VS Code，装个插件就能愉快地写代码了，结果却陷入了一场与"uv"的纠缠中。如果你也遇到了类似的问题，希望这篇文章能帮到你。

故事开始：干净的电脑，纯净的系统

想象一下：一台全新的电脑，Windows系统刚装好，VS Code刚刚下载安装完成，一切都是崭新的开始。

第一步：安装Python插件

打开VS Code，在扩展商店搜索"Python"，找到了官方的Python扩展（发布者：Microsoft）。点击安装，一切看起来很顺利。

第二步：发现新大陆------Python Environment Manager

安装完Python扩展后，VS Code提示我还有一个推荐的插件："Python Environment Manager"。本着"推荐的就是好的"原则，我也把它装上了。

第三步：开启配置

安装完Python Environment Manager后，右下角弹出一个提示，说要设置什么"python environment manager"为true。虽然看不懂，但既然是提示，那就照做呗。在设置里搜索找到，勾选上。

第四步：点击蟒蛇图标

左侧活动栏出现了一个可爱的蟒蛇图标，我兴奋地点开。心想：这下可以开始写Python了吧？

结果，弹出一个提示框：

"没有找到uv"

啥是uv？我一脸懵。

第五步：自动安装uv

提示框里有个"安装"按钮，我点击了。只见终端窗口闪了一下，似乎安装了什么。根据提示，uv被安装到了：
C:\Users\Administrator\.local\bin

打开这个文件夹，看到了三个可执行文件：

uvx.exe
uvw.exe
uv.exe

按照提示，我手动将这个路径添加到了系统的PATH环境变量中。

第六步：重启VS Code，然并卵

满怀期待地重启VS Code，再次点击蟒蛇图标------还是那个熟悉的提示：

"没有找到uv"

这一刻，我的内心是崩溃的。

探索：手动使用uv

既然自动的不行，那我就手动来。打开PowerShell（管理员模式），开始了我的"命令行探险"。

1. 安装Python

powershell 复制代码

PS C:\Users\Administrator> uv python install

终端输出：

复制代码

Installed Python 3.14.3 in 2.65s
 + cpython-3.14.3-windows-x86_64-none (python3.14.exe)

这是什么意思？

uv python install：告诉uv工具安装Python
输出显示成功安装了Python 3.14.3版本，用时2.65秒
cpython-3.14.3-windows-x86_64-none：这是Python的一个具体版本标识
- cpython：用C语言实现的Python（就是官方版本）
- 3.14.3：版本号
- windows-x86_64：64位Windows版本
- none：表示没有特殊的编译选项
- python3.14.exe：安装后生成的可执行文件名

2. 查看已安装的包

powershell 复制代码

PS C:\Users\Administrator> uv pip list

终端输出：

复制代码

Using Python 3.14.3 environment at: AppData\Roaming\uv\python\cpython-3.14.3-windows-x86_64-none
Package Version
------- -------
pip     26.0.1

这是什么意思？

uv pip list：用uv工具列出当前Python环境中安装的所有包
Using Python 3.14.3 environment at:：显示当前使用的Python环境位置
AppData\Roaming\uv\python\...：Python环境实际安装的位置（这是用户目录下的隐藏文件夹）
表格显示只有一个包：pip，版本26.0.1
- pip：Python的包管理工具，用来安装其他Python库
- 新安装的Python默认都会带pip

疑惑与思考

虽然手动安装成功了，但我依然有很多疑问：

为什么VS Code的插件找不到uv？
- 明明已经添加了PATH，也重启了VS Code
- 可能是VS Code没有重新加载环境变量？
- 或者是插件有自己的一套查找机制？
uv到底是什么？
- 通过摸索，我发现uv是一个用Rust编写的极速Python包安装工具
- 它可以管理Python版本（像pyenv）
- 也可以管理虚拟环境和包（像pip/poetry）
- 可以说是新一代的Python工具链
安装的Python到底在哪里？
- 表面上看在 .local\bin，实际上Python解释器在 AppData\Roaming\uv\python\...
- .local\bin里只有uv相关的exe文件
那些输出信息到底在说什么？
- 每个符号、每个路径都有它的意义
- 就像是在读一本天书，每个字都认识，连起来就不懂了

未完待续...

故事到这里还没有结束。虽然手动能用uv了，但VS Code插件依然不认。这让我意识到，从"能用"到"好用"，中间还有很长的路要走。

作为一个编程新手，这次的经历让我深刻体会到：看似简单的环境配置，背后可能藏着无数的坑。每一个报错、每一个提示，都在指引我们去了解更多。

如果你知道为什么VS Code插件找不到uv，或者有解决方案，欢迎在评论区告诉我。让我们一起在编程的道路上，从懵懂到明白，从明白到精通。

最后，送给同样在配置环境的朋友们：

不要被各种术语吓到
每一个错误都是学习的机会
当你不懂时，至少知道自己在不懂什么
编程的路上，你并不孤单

【 从零开始的VS Code Python环境配置：uv】