访问 python.org 下载最新稳定版。截至2026年3月,最新稳定版为 Python 3.12.2(LTS版本)和 Python 3.13.0rc1(预览版)。请务必选择与操作系统匹配的安装包:
| 平台 | 安装包类型 | 文件名特征 | 推荐安装方式 |
|---|---|---|---|
| Windows | 可执行安装程序 | python-3.12.2-amd64.exe | 勾选“Add to PATH”后安装 |
| macOS | PKG安装包 | python-3.12.2-macos11.pkg | 双击PKG安装 |
| Linux | 源码压缩包 | Python-3.12.2.tgz | 源码编译或包管理器 |
Windows用户需特别注意环境变量配置。安装时务必勾选底部的“Add Python 3.12 to PATH”选项,否则后续需手动添加路径。
安装完成后,打开命令提示符(cmd)或PowerShell,执行:
若显示版本号(如Python 3.12.2),则环境配置成功。若提示“'python' 不是内部或外部命令”,请检查:
macOS系统自带Python 2.7(已停止维护),但现代开发需独立安装Python 3。推荐通过官方PKG安装,也可使用Homebrew:
安装后验证命令:
注意:macOS 12 Monterey起默认禁用32位应用,但Python 3.12+已完全移除32位支持,无需额外处理。
Linux发行版通常预装Python,但多为2.x版本或精简版。Ubuntu/Debian系推荐:
RHEL/CentOS系:
源码编译(适用于需要特定版本或优化):
编译后将新路径加入PATH:
全局安装依赖存在三大风险:
虚拟环境通过创建独立的site-packages目录,确保每个项目拥有专属依赖空间,同时避免权限问题。
Python 3.3+内置模块,轻量级解决方案:
.venv(以.开头),使其在IDE中默认隐藏,保持项目目录整洁。
官方推荐工具,集成虚拟环境与依赖管理:
自动生成Pipfile与Pipfile.lock,确保依赖精确锁定:
现代Python项目管理工具,支持依赖解析与发布流程:
优势在于:
pyproject.toml配置文件requests = "^2.28.0").venv/),避免跨磁盘路径问题python3.12 -m venv .venv.venv,VS Code需在命令面板选择解释器路径requirements.txt用于迁移:pip freeze > requirements.txtfind . -name ".venv" -type d -exec rm -rf {} +(Linux/macOS)
JetBrains PyCharm提供三版本:Community(免费)、Professional(付费)、Edu(教学版)。推荐专业版用于企业开发。
首次启动配置流程:
.venv/bin/python路径微软VS Code凭借轻量级与强大扩展生态成为Python主流选择。
必备扩展:
settings.json关键配置:
终端是开发效率核心,推荐配置:
终端提示符增强示例(Zsh):
激活虚拟环境时自动显示环境名:
PyCharm调试设置:
VS Code调试:
.vscode/launch.jsonprint()调试时,考虑替换为logging.debug()避免污染输出breakpoint()内置函数替代import pdb; pdb.set_trace()
企业级项目常因历史原因需支持旧版本:
全局切换Python版本易导致环境混乱,需专用工具管理。
pyenv安装(Linux/macOS):
添加到shell配置:
常用命令:
xcode-select --install,否则编译失败。
Windows用户使用pyenv-win(非官方移植版):
配置系统PATH:
常用命令:
C:\Users\用户名\Documents\Projects\...\pyenv),建议直接放在C:\pyenv。
场景:将Django 3.2项目迁移到Python 3.12
pip install --dry-run django==3.2.25pyenv local 3.12.2 && python -m venv .venvpip install "django>=4.2,<5.0"python manage.py check --deploypytest)pyupgrade自动升级语法:pyupgrade --py312-plus *.py
错误现象:
PermissionError: [Errno 13] Permission denied: '/usr/local/lib/python3.10/site-packages/xxx'
根本原因:使用sudo pip安装导致权限混乱
修复方案:
sudo pip install!改用pip install --user或虚拟环境。
错误现象:
ModuleNotFoundError: No module named 'requests'
排查步骤:
which pythonpip list | grep requestspip install --force-reinstall requestspip checkpip install -r requirements.txt重建环境(确保文件存在)。
错误现象:
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xXX in position XX
解决方案:
utf-8编码保存(IDE设置中检查“File Encodings”)。
错误现象:
ImportError: cannot import name 'xxx' from partially initialized module
根本原因:循环导入或路径未正确设置
修复方案:
from package.module import funcexport PYTHONPATH="${PYTHONPATH}:/path/to/your/project"python -c "import sys; print(sys.path)" 查看当前导入路径
典型场景:
安装mysqlclient时失败:error: command 'gcc' failed with exit status 1
解决方案:
PyMySQL或mysql-connector-python(无需编译)。
Python官方包管理器,简单直接:
局限:无法解决复杂依赖冲突,需配合pip-tools或pipenv使用。
Anaconda发行版自带工具,擅长科学计算:
优势:预编译二进制包,安装速度极快;支持非Python依赖(如GDAL、FFmpeg)。
Rust编写的超快包管理器(比pip快10倍):
特点:单文件可执行、零依赖、支持锁定文件uv.lock。
pre-commit钩子中集成这些工具,提交前自动检查。
方案1:requirements.txt(通用)
方案2:pip-tools(精确锁定)
方案3:poetry export(标准格式)
sys.path修改)。
运行以下命令查看全局包列表:
若输出超过20个包,说明环境已污染,建议使用虚拟环境重建。
配置国内镜像源(以清华大学为例):
在Linux/macOS中使用python2和python3命令区分:
Windows中通过py启动器管理:
使用pip-autoremove:
或手动清理(谨慎操作):