Skip to content

Python 开发环境

基于 uv 构建的现代 Python 开发环境配置,一个工具替代 pip + venv + pyenv。

uv 安装

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

验证安装:

powershell
uv --version

相关链接:

Python 版本管理

uv 直接管理 Python 版本,无需系统级安装,需要时自动下载。

powershell
uv python install 3.12        # 安装指定版本
uv python install 3.11 3.12   # 安装多个版本
uv python list                 # 查看可安装版本
uv python list --only-installed  # 查看已安装版本
uv python uninstall 3.11      # 卸载版本

工作原理

uv 将 Python 安装在用户目录下的独立存储中(%APPDATA%\uv\python),不影响系统 PATH。

相关链接: Python 官网 | 下载页

项目级管理

使用 uv init 初始化项目,基于 pyproject.toml + uv.lock 管理依赖,类似 npm 的 package.json + package-lock.json。

初始化与依赖:

powershell
uv init my-project   # 初始化新项目
cd my-project
uv add requests      # 添加依赖
uv add --dev pytest  # 添加开发依赖
uv remove requests   # 移除依赖

运行与同步:

powershell
uv run python main.py  # 运行脚本(自动使用项目环境)
uv run pytest           # 运行测试
uv lock                 # 更新依赖锁定文件
uv sync                 # 安装/同步所有锁定依赖
uv sync --locked        # 严格按锁定文件同步(推荐用于 CI)

全局依赖安装

日常临时安装工具包时使用全局 pip,需加 --system 标记:

powershell
uv pip install --system requests         # 安装包
uv pip install --system --upgrade requests  # 升级包
uv pip uninstall --system requests       # 卸载包
uv pip freeze --system > requirements.txt  # 导出已安装包

注意

项目级依赖必须通过 uv add 管理,不要与全局 --system 混用。

IDE / 编辑器

PyCharm

JetBrains 出品的专业 Python IDE,开箱即用,内置智能提示、调试、测试、数据库工具等。

  • 社区版免费,专业版付费(支持 Web 开发、远程解释器等)
  • 适合大型项目和需要完整 IDE 体验的开发者

下载 PyCharm

VS Code

轻量级编辑器,配合插件使用:

  • Python - 官方 Python 扩展
  • Pylance - 语言服务器,提供智能提示
  • Python Debugger - 调试支持
  • Ruff - 超快的 Linter 和 Formatter
  • Jupyter - Notebook 支持

下载 VS Code