Skip to content

Python 开发环境

Python 开发的基础环境配置。

Python 安装

使用 winget

powershell
# 安装最新版本
winget install Python.Python.3.12

手动安装

下载地址: https://www.python.org/downloads/

注意

安装时勾选 "Add Python to PATH"。

验证安装:

powershell
python --version
pip --version

版本管理

pyenv-win

Windows 下的 Python 版本管理工具。

安装:

powershell
# 使用 PowerShell 安装
Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "./install-pyenv-win.ps1"; &"./install-pyenv-win.ps1"

提示

pyenv-win 不在 winget 仓库中,需通过 PowerShell 脚本安装。

常用命令:

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

# 安装指定版本
pyenv install 3.12.0

# 设置全局版本
pyenv global 3.12.0

# 设置当前目录版本
pyenv local 3.11.0

# 查看已安装版本
pyenv versions

虚拟环境

venv (内置)

Python 3.3+ 内置的虚拟环境工具。

powershell
# 创建虚拟环境
python -m venv .venv

# 激活虚拟环境
.\.venv\Scripts\Activate.ps1

# 退出虚拟环境
deactivate

uv (推荐)

Rust 编写的超快 Python 包管理器,可替代 pip 和 venv。

安装:

powershell
winget install astral-sh.uv

常用命令:

powershell
# 创建虚拟环境
uv venv

# 激活
.\.venv\Scripts\Activate.ps1

# 安装依赖(比 pip 快 10-100 倍)
uv pip install requests

# 从 requirements.txt 安装
uv pip install -r requirements.txt

# 同步依赖
uv pip sync requirements.txt

推荐

uv 是目前最快的 Python 包管理器,强烈推荐使用。

包管理

pip

Python 自带的包管理器。

powershell
# 安装包
pip install <package>

# 升级包
pip install --upgrade <package>

# 导出依赖
pip freeze > requirements.txt

# 安装依赖
pip install -r requirements.txt

配置镜像:

powershell
# 临时使用
pip install <package> -i https://pypi.tuna.tsinghua.edu.cn/simple

# 永久配置
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

IDE / 编辑器

PyCharm

下载地址: https://www.jetbrains.com/pycharm/

安装:

powershell
# 社区版(免费)
winget install JetBrains.PyCharm.Community

# 专业版(付费)
winget install JetBrains.PyCharm.Professional

VS Code

轻量级选择,配合插件使用:

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