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 tensorflowpip 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版本选择 3.8 / 3.9 / 3.10 虚拟环境创建 venv / conda pip源配置 清华源 / 阿里源 常见Python包安装 numpy / scipy / matplotlib / pandas / sklearn 环境验证 import测试 / 版本检查 遵循这个流程,99%的环境问题都能避免

好了,Python环境搭建这块就这些内容。你按照上面的步骤来,基本不会出大问题。如果遇到什么奇怪的报错,先检查Python版本,再检查虚拟环境是否激活,最后看看pip源配没配对——这三个地方出问题的概率最大。

专注资料整理