Python 开发环境配置

Python 解释器、包管理、IDE 完整配置指南

安装流程

1

安装 Python

2

配置 pip

3

安装虚拟环境

4

安装 IDE

Python 安装

版本选择建议：推荐使用 Python 3.10+，目前最稳定的是 Python 3.11/3.12。避免使用 Python 2（已停止支持）

Python 官方

Python 官方网站下载

Python 3.12 - 最新版本
Python 3.11 - 稳定版本（推荐）
Python 3.10 - 长期支持

官方下载

验证安装：

python --version
pip --version

Anaconda（数据科学推荐）

Python 数据科学发行版

预装常用科学计算库
conda 包管理
环境管理方便

官方下载清华镜像

Windows 安装重要提示

关键步骤：安装时务必勾选 "Add Python to PATH" 选项！

这样可以自动配置环境变量，否则需要手动配置：

1. 新建系统变量

PYTHON_HOME = C:\Users\你的用户名\AppData\Local\Programs\Python\Python311

2. 编辑 Path 变量

%PYTHON_HOME%
%PYTHON_HOME%\Scripts

pip 包管理配置

配置国内镜像源

使用国内镜像可以大幅提升 pip 安装速度

1. 临时使用（单次有效）

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 包名

2. 永久配置（推荐）

# 在命令行执行：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# 配置文件位置：
# Windows: %APPDATA%\pip\pip.ini
# Linux/Mac: ~/.config/pip/pip.conf

3. 常用国内镜像源

镜像源	地址
清华大学	https://pypi.tuna.tsinghua.edu.cn/simple
阿里云	https://mirrors.aliyun.com/pypi/simple/
中国科学技术大学	https://pypi.mirrors.ustc.edu.cn/simple/
豆瓣	https://pypi.douban.com/simple/

虚拟环境管理

最佳实践：每个项目使用独立的虚拟环境，避免包版本冲突

venv（内置）

Python 3 内置的虚拟环境工具

创建虚拟环境：

python -m venv myenv

激活虚拟环境：

# Windows
myenv\Scripts\activate

# Linux/Mac
source myenv/bin/activate

退出虚拟环境：

deactivate

virtualenv

第三方虚拟环境工具，功能更丰富

安装：

pip install virtualenv

创建环境：

virtualenv myenv
# 或指定 Python 版本
virtualenv -p python3.11 myenv

Conda

Anaconda 的环境管理工具

创建环境：

conda create -n myenv python=3.11

激活环境：

conda activate myenv

查看环境：

conda env list

Poetry

现代化的依赖管理和打包工具

安装：

pip install poetry

创建项目：

poetry new myproject
cd myproject
poetry install

开发工具 (IDE)

PyCharm（强烈推荐）

最专业功能全面

JetBrains 出品的专业 Python IDE

版本选择：

Community 版 - 免费，基础 Python 开发
Professional 版 - 付费，支持 Web 框架、数据库等

学生可申请免费教育许可证

Visual Studio Code

免费轻量

微软出品的通用代码编辑器

必备 Python 插件：

Python (Microsoft)
Pylance
Python Indent
Python Test Explorer

官方下载

Jupyter Notebook

交互式编程环境，数据科学首选

代码、文档、结果一体化
数据分析和可视化
教学和学习友好

pip install jupyterlab
jupyter lab

Thonny（初学者推荐）

为 Python 初学者设计的轻量 IDE

界面简洁
内置 Python
变量可视化

常用 Python 库

网络请求

• requests - HTTP 请求
• aiohttp - 异步 HTTP
• httpx - 现代 HTTP 客户端

数据处理

• pandas - 数据分析
• numpy - 数值计算
• openpyxl - Excel 操作

数据可视化

• matplotlib - 绘图库
• seaborn - 统计图表
• plotly - 交互式图表

机器学习

• scikit-learn - ML 算法
• tensorflow - 深度学习
• pytorch - 深度学习

Web 框架

• Django - 全功能框架
• Flask - 轻量框架
• FastAPI - 现代 API 框架

爬虫

• scrapy - 爬虫框架
• beautifulsoup4 - HTML 解析
• selenium - 浏览器自动化

文本处理

• jieba - 中文分词
• pillow - 图像处理
• python-docx - Word 处理

测试

• pytest - 测试框架
• unittest - 单元测试
• coverage - 覆盖率

常见问题与注意事项

配置国内镜像源可以大幅提升下载速度：

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

# 临时使用
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 包名

使用虚拟环境的好处：

隔离依赖 - 不同项目可能需要不同版本的包
避免冲突 - 全局安装可能导致版本冲突
便于部署 - 可以导出精确的依赖列表
保持清洁 - 不污染系统 Python 环境

# 导出依赖
pip freeze > requirements.txt

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

这是环境变量配置问题：

确认安装时勾选了 "Add Python to PATH"
手动添加 Python 安装目录到 Path 环境变量
添加 Python 和 Scripts 两个目录
重新打开命令提示符

# 验证安装
python --version
pip --version

IDE	适合人群	特点
PyCharm	专业开发者	功能最全、智能提示强
VS Code	通用开发者	轻量、多语言支持
Jupyter	数据科学家	交互式、可视化好
Thonny	初学者	简单易用、教学友好

1. 使用 requirements.txt（传统方式）

# 导出当前环境所有包
pip freeze > requirements.txt

# 从文件安装
pip install -r requirements.txt

2. 使用 Poetry（推荐）

# 添加依赖
poetry add requests

# 开发依赖
poetry add --group dev pytest

# 安装所有依赖
poetry install

环境验证命令

安装完成后，打开命令提示符运行以下命令验证：

# 验证 Python
python --version

# 验证 pip
pip --version

# 验证虚拟环境工具
python -m venv --help

# 测试运行 Python 脚本
python -c "print('Hello, Python!')"