4、Python环境搭建:版本选择、虚拟环境与包管理
Python环境搭建,说实话是Reality AI工具链里最容易出幺蛾子的环节。我见过太多人卡在这一步,明明算法模型跑得好好的,结果环境没配好,折腾一整天。今天咱们就把这事彻底捋清楚。
4.1 Python版本选择:3.8、3.9还是3.10?
这个问题我几乎每次培训都会被问到。我的建议很直接:Reality AI目前官方推荐Python 3.8或3.9。3.10虽然新特性多,但有些底层库还没完全适配。
| Python版本 | Reality AI兼容性 | 我的建议 |
|---|---|---|
| 3.8 | 完全兼容,经过大量验证 | ✅ 首选,稳定可靠 |
| 3.9 | 兼容性良好 | ✅ 可选,部分新库支持更好 |
| 3.10 | 部分库有兼容问题 | ⚠️ 谨慎使用,我踩过坑 |
⚠️ 避坑指南:我曾经在Python 3.10上安装Reality AI的某个依赖库时,遇到了numpy编译失败的问题。折腾了两天才发现是版本不兼容。所以,老老实实用3.8吧,省心。
4.2 虚拟环境创建:venv vs conda
虚拟环境这东西,说白了就是给你的每个项目一个独立的Python小天地。我个人的习惯是:项目简单用venv,项目复杂用conda。
4.2.1 使用venv(轻量级方案)
venv是Python自带的,不需要额外安装。适合单个项目、依赖不复杂的情况。
# 创建虚拟环境
python -m venv reality_ai_env
# 激活环境(Windows)
reality_ai_env\Scripts\activate
# 激活环境(Linux/Mac)
source reality_ai_env/bin/activate
# 退出环境
deactivate
4.2.2 使用conda(重量级方案)
conda适合需要管理多个Python版本、或者有复杂科学计算依赖的项目。Reality AI工具链我建议用conda,因为它的依赖管理更智能。
# 创建环境并指定Python版本
conda create -n reality_ai_env python=3.8
# 激活环境
conda activate reality_ai_env
# 退出环境
conda deactivate
# 删除环境
conda env remove -n reality_ai_env
💡 我的经验:如果你同时做多个AI项目,建议每个项目都建独立的虚拟环境。我见过有人把所有包装到base环境里,结果版本冲突到崩溃。嗯,那个人就是我。
4.3 pip源配置:下载速度翻倍
pip默认源在国外,下载速度慢得让人抓狂。配置国内镜像源后,速度能快10倍以上。我个人常用清华源和中科大源。
4.3.1 临时使用
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple some-package
4.3.2 永久配置
# 创建或修改配置文件
# Linux/Mac: ~/.pip/pip.conf
# Windows: %USERPROFILE%\pip\pip.ini
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
🔑 关键点:配置好pip源后,记得加上
trusted-host,否则有些公司内网环境会报SSL错误。我当初在客户现场部署时就因为这个卡了半小时。
4.4 常见Python包安装
Reality AI工具链需要安装的包不算多,但有几个关键依赖必须装对。下面是我整理的核心包清单:
| 包名 | 用途 | 安装命令 |
|---|---|---|
| numpy | 数值计算基础库 | pip install numpy |
| scipy | 科学计算工具 | pip install scipy |
| matplotlib | 数据可视化 | pip install matplotlib |
| pandas | 数据处理与分析 | pip install pandas |
| scikit-learn | 机器学习工具包 | pip install scikit-learn |
| tensorflow 或 pytorch | 深度学习框架(按需选择) | pip install tensorflow 或 pip install torch |
⚠️ 避坑指南:安装tensorflow或pytorch时,一定要注意CPU/GPU版本。如果你没有NVIDIA显卡,千万别装GPU版本,否则会报错。我曾经在服务器上装错了版本,排查了一下午才发现是驱动问题。
4.5 一键安装脚本
为了省事,我写了个一键安装脚本。你直接复制到终端运行就行:
# 安装Reality AI核心依赖
pip install numpy scipy matplotlib pandas scikit-learn
# 如果要用深度学习,选一个安装
# pip install tensorflow
# pip install torch
# 验证安装
python -c "import numpy; import scipy; import matplotlib; print('All packages installed successfully!')"
4.6 知识体系总览
下面这张图帮你理清Python环境搭建的完整流程:
好了,Python环境搭建这块就这些内容。你按照上面的步骤来,基本不会出大问题。如果遇到什么奇怪的报错,先检查Python版本,再检查虚拟环境是否激活,最后看看pip源配没配对——这三个地方出问题的概率最大。