3. Python 开发环境搭建：Python 安装、虚拟环境配置、pip 换源、常用 IDE 推荐

在开始编写催收触达波动监控脚本之前，必须搭建一个稳定、可复现的 Python 开发环境。本章将依次完成 Python 解释器安装、虚拟环境隔离、pip 包管理器加速，并推荐两款主流 IDE，确保后续开发过程顺畅无阻。

3.1 Python 解释器安装

Python 官方维护两个主要版本线：Python 3.8+ 是当前监控脚本的推荐基线。请根据操作系统选择对应安装包。

操作系统	下载来源	安装注意事项
Windows	python.org 或 Microsoft Store	安装时务必勾选 “Add Python to PATH”
macOS	python.org 或 Homebrew (brew install python@3.11)	系统自带 Python 2 不要卸载，使用 python3 命令
Linux (Ubuntu/Debian)	sudo apt install python3 python3-pip python3-venv	不要覆盖系统默认的 python3 链接

3.2 虚拟环境配置

虚拟环境为每个项目创建独立的 Python 运行沙箱，避免不同项目间的依赖冲突。Python 3.3+ 内置 venv 模块，无需额外安装。

3.2.1 创建与激活虚拟环境

# 在项目根目录下创建虚拟环境（命名为 venv 是行业惯例）
python3 -m venv venv

# 激活虚拟环境
# Windows (CMD/PowerShell)
venv\Scripts\activate

# macOS / Linux (bash/zsh)
source venv/bin/activate

# 激活后终端提示符前会出现 (venv) 标识

3.2.2 退出与删除虚拟环境

# 退出当前虚拟环境
deactivate

# 删除虚拟环境（直接删除目录即可）
rm -rf venv   # macOS/Linux
rmdir /s venv # Windows

3.3 pip 换源（国内加速）

pip 默认从官方 PyPI 服务器下载包，国内访问速度较慢。配置国内镜像源可显著提升下载速度。推荐使用 清华大学 TUNA 镜像源 或 阿里云镜像源。

3.3.1 临时换源

# 安装单个包时指定镜像源
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

3.3.2 永久换源

# 配置为清华源（推荐）
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# 验证配置是否生效
pip config list

镜像源名称	URL	适用地区
清华大学 TUNA	https://pypi.tuna.tsinghua.edu.cn/simple	全国（推荐）
阿里云	https://mirrors.aliyun.com/pypi/simple	全国
中国科学技术大学 USTC	https://pypi.mirrors.ustc.edu.cn/simple	华东/华中
华为云	https://repo.huaweicloud.com/repository/pypi/simple	全国

3.4 常用 IDE 推荐

对于催收监控脚本开发，推荐两款主流 IDE：PyCharm（专业级）和 VSCode（轻量级）。以下从多个维度对比，帮助您根据项目规模做出选择。

对比维度	PyCharm (Community/Professional)	VSCode + Python 扩展
启动速度	较慢（需加载项目索引）	极快（秒开）
Python 开箱体验	★★★★★ 原生支持，无需配置	★★★★ 需安装 Python 扩展
虚拟环境管理	自动检测并激活	手动选择解释器
调试器	图形化断点、变量监视、堆栈跟踪	功能完整，需熟悉快捷键
代码补全	智能、上下文感知	依赖 Pylance，效果接近
Git 集成	内置，可视化操作	需安装 GitLens 等扩展
资源占用	较高（约 800MB-1.2GB）	较低（约 300-500MB）
适合场景	中大型项目、团队协作	快速脚本、轻量开发、多语言

3.4.1 PyCharm 快速配置

# 1. 下载安装：https://www.jetbrains.com/pycharm/download
# 2. 打开项目，File → Settings → Project → Python Interpreter
# 3. 点击齿轮图标 → Add → Existing environment → 选择 venv/bin/python
# 4. 确认解释器路径后，PyCharm 自动加载已安装的包列表

3.4.2 VSCode 快速配置

# 1. 下载安装：https://code.visualstudio.com
# 2. 安装 Python 扩展（ms-python.python）
# 3. 打开项目文件夹，按 Ctrl+Shift+P → Python: Select Interpreter
# 4. 选择虚拟环境中的 python 解释器（路径如 ./venv/bin/python）
# 5. 创建 .vscode/settings.json 文件，添加：
{
    "python.defaultInterpreterPath": "./venv/bin/python",
    "python.terminal.activateEnvironment": true
}

3.5 环境验证清单

完成上述步骤后，执行以下命令验证整个开发环境是否就绪：

# 1. 检查 Python 版本
python3 --version
# 输出示例：Python 3.11.5

# 2. 检查 pip 版本及镜像源
pip --version
pip config list
# 确认 index-url 指向清华源

# 3. 创建并激活虚拟环境
python3 -m venv test_venv
source test_venv/bin/activate

# 4. 安装一个测试包
pip install requests
python -c "import requests; print(requests.__version__)"
# 输出示例：2.31.0

# 5. 退出并清理测试环境
deactivate
rm -rf test_venv