掌握 VS Code 中的 'uv'：超快速 Python 设置指南

Source: Dev.to

什么是 “uv”？

由 Astral（Ruff 背后的团队）开发，并使用 Rust 编写，uv 是一个极其快速的 Python 包安装器和解析器。它旨在成为 pip、pip‑tools 和 virtualenv 的“一站式”替代方案。基准测试显示，它比传统工具 快 10×–100×。

对 VS Code 用户的好处

• 瞬时环境搭建 – 再也不必等待依赖解析。
• 磁盘空间高效 – 优化的全局缓存。
• 一致性 – uv.lock 文件确保每位团队成员使用完全相同的环境。

第一步：安装 uv

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows（PowerShell）

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

安装完成后，验证一下：

uv --version

第二步：让 VS Code 识别 uv

1. 初始化项目并创建虚拟环境

# 初始化项目（创建 pyproject.toml）
uv init

# 创建虚拟环境（生成 .venv 文件夹）
uv venv

2. 在 VS Code 中选择解释器

1. 打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）。
2. 选择 “Python: Select Interpreter.”
3. 选取新建的 .venv 文件夹中的 Python 可执行文件。

提示： 如果环境没有出现，可在 settings.json 中添加以下内容：

{
  "python.venvPath": ".",
  "python.venvFolders": [".venv"]
}

第三步：包管理（uv add / uv sync）

添加生产依赖：

uv add fastapi

添加开发依赖：

uv add --dev pytest

当新成员克隆仓库时，只需运行以下命令即可瞬间同步完整环境：

uv sync

第四步：调试配置（launch.json）

在 .vscode/launch.json 中创建（或编辑已有的）如下配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: Current File (uv)",
      "type": "python",
      "request": "launch",
      "program": "${file}",
      "console": "integratedTerminal",
      "justMyCode": true
    }
  ]
}

现在可以在 uv 管理的环境中直接设置断点并调试代码（按 F5 开始调试）。

专业技巧：与 Ruff 集成

由于 Ruff 与 uv 出自同一团队，它们配合得天衣无缝。

1. 为 VS Code 安装 Ruff 扩展。
2. 将 Ruff 添加为开发依赖：

uv add --dev ruff

3. 配置 VS Code 使用 Ruff 作为默认格式化工具：

{
  "[python]": {
    "editor.defaultFormatter": "charliermarsh.ruff",
    "editor.formatOnSave": true,
    "editor.codeActionsOnSave": {
      "source.fixAll": "explicit",
      "source.organizeImports": "explicit"
    }
  }
}

这样，每次保存时代码都会以闪电般的速度进行 lint 和格式化。

结论

切换到 uv 可能是你在 2026 年提升 Python 开发体验的最具影响力的单一改变。配合 VS Code 与 Ruff，你将拥有一个快速、稳健且现代的开发环境。

最初发布于：