[!info] related notes

• 所属 MOC: python-moc, development-environment-moc
• 相关工具: uv, ruff, pylance
• 关系笔记: python-package-management-evolution

---

Python环境配置

windows（scoop）

python 本体

# 安装最新稳定版 Python（会自动添加到 PATH） 
scoop install python 

# 安装指定版本（如 Python 3.9） 
scoop install python39

多 Python 版本管理

[!info] tip 现在推荐直接使用 uv，见下方

# 安装 pipenv（虚拟环境 + 依赖管理）
scoop install pipenv

# 安装 poetry（现代依赖管理工具，支持虚拟环境）
scoop install poetry

# 安装 pyenv-win（Python 版本管理器，配合 scoop 使用更灵活）
scoop install pyenv-win

pyenv 使用

# 查看可安装的 Python 版本
pyenv install --list

# 安装指定版本
pyenv install 3.10.11

# 为当前项目设置本地版本
pyenv local 3.10.11

# 查看当前生效版本
pyenv version

Vscode

微软（Microsoft）官方提供的 Python 核心扩展家族。微软近年来将原本臃肿的单一 Python 插件拆分成了一系列模块化的插件，以提高性能和稳定性。

以下是几个 Python 相关插件的具体作用：

• Python (核心基础插件)
  • 作用：这是 VS Code 中最基础的 Python 插件。它提供了 Python 开发的整体框架支持，相当于一个“入口”。它负责协调其他 Python 相关插件，并提供代码格式化、测试工具集成（如 pytest）以及基础的终端执行功能。
• Pylance (语言服务器 / 智能提示)
  • 作用：这是你的“代码大脑”。Pylance 是一个高性能的语言服务器，专门负责智能代码补全（IntelliSense）。当你敲击代码时弹出的函数提示、参数说明、变量类型检查、自动导入（Auto-import）以及代码跳转（Go to Definition）等功能，全都是它的功劳。
• Python Debugger (代码调试器)
  • 作用：专门负责找 Bug 和调试代码。它基于 debugpy 构建，让你可以在 VS Code 中设置断点、单步执行代码（F5/F10/F11）、监控变量在运行时的实时状态。这个功能以前包含在核心的 Python 插件中，现在被独立出来以便单独更新。
• Python Environments (环境管理器)
  • 作用：专门负责管理你的 Python 运行环境。在 Python 开发中，我们经常使用虚拟环境（如 venv, conda, poetry 等）来隔离项目依赖。这个插件可以自动扫描并帮助你在右下角快速切换当前项目所使用的解释器和虚拟环境。

uv 与 VS Code 集成（推荐方案）

现代 Python 开发推荐使用 uv 作为工具链，配合 VS Code 的 Python 插件家族。

工具分工

工具	职责
uv	环境管理、包管理、Python 版本管理
Pylance	代码补全、类型检查、代码导航
Ruff	代码格式化、Linting 检查

完整配置

在项目根目录的 .vscode/settings.json 中添加：

{
  "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
  "python.languageServer": "Pylance",
  "python.analysis.typeCheckingMode": "basic",
  "[python]": {
    "editor.defaultFormatter": "charliermarsh.ruff",
    "editor.formatOnSave": true,
    "editor.codeActionsOnSave": {
      "source.fixAll": "explicit",
      "source.organizeImports.ruff": "explicit"
    }
  }
}

Windows 用户使用：

{
  "python.defaultInterpreterPath": "${workspaceFolder}\\.venv\\Scripts\\python.exe"
}

插件选择建议

保留的插件：

• VS Code 官方 Python 插件（Microsoft 出品）
• Pylance（智能提示和类型检查）
• Ruff 插件（代码格式化和检查）

可以卸载的插件：

• Poetry 相关插件
• Pipenv 相关插件
• 第三方虚拟环境管理 UI 插件

使用流程

1. 使用 uv 创建项目：uv init my-project
2. 使用 uv 添加依赖：uv add requests
3. 打开 VS Code，自动识别 .venv 环境
4. 享受 Pylance 的智能提示和 Ruff 的自动格式化

详细配置参考 uv 笔记。