4、Python基础环境搭建：Python 3.9/3.10安装、环境变量配置、pip换源、虚拟环境创建与激活
各位同学，咱们直接进入正题。Python环境搭建，说白了就是给工业视觉软件找个靠谱的“家”。我见过太多新手在这步栽跟头，后面调试代码时各种报错，查半天发现是Python版本不对或者路径没配好。今天咱们一步到位，把这事整明白。
4.1 为什么选Python 3.9或3.10？
你可能要问：Python都出到3.12了，为啥还推荐老版本？
嗯，这里有个坑。工业视觉领域很多核心库，比如OpenCV的某些扩展模块、Halcon的Python接口、还有部分深度学习框架的旧版本，对Python 3.11以上支持并不好。我在项目里遇到过，用Python 3.11装某个工业相机SDK，死活编译不过去，换成3.9就一路绿灯。
我个人习惯是：新项目用Python 3.10，维护老项目用Python 3.9。这两个版本稳定，生态成熟，市面上99%的工业视觉库都能跑。
- Python 3.9.13 —— 最稳妥，兼容性最好
- Python 3.10.11 —— 性能略优，支持新语法
- 不要用3.8以下版本（很多库已停止支持）
- 暂时避开3.11+（除非你确认所有依赖都兼容）
4.2 安装Python（以Windows为例）
下载地址我就不贴了，直接去python.org，找到Downloads，选Windows版本。注意区分64位和32位——现在基本都是64位系统，别选错。
安装时有个关键操作：勾选“Add Python to PATH”。这一步很多人会忘，导致后面命令行里打python没反应。我刚开始带徒弟时，十个人里有六个栽在这上面。
- 安装路径不要带中文和空格（比如C:\Python310）
- 选择“Customize installation”，确保pip被勾选
- 安装完成后，打开cmd输入
python --version验证
# 验证安装
C:\Users\YourName> python --version
Python 3.10.11
C:\Users\YourName> pip --version
pip 23.2.1 from C:\Python310\lib\site-packages\pip (python 3.10)
4.3 环境变量配置（手动补坑）
如果你安装时忘了勾PATH，或者想自己管理，可以手动配。右键“此电脑” → 属性 → 高级系统设置 → 环境变量。
在系统变量里找到Path，添加这两条：
C:\Python310 # Python安装目录
C:\Python310\Scripts # pip等脚本目录
为什么要配Scripts？因为后面装包时，很多命令行工具（比如pyinstaller、jupyter）都放在这里。我曾经帮一个同事排查问题，他pip install成功了，但命令行找不到命令，就是Scripts没加进PATH。
py -3.10 这样的命令指定版本。
4.4 pip换源——下载速度翻10倍
用过pip的都知道，默认源在国外，下载一个几十MB的包能等到你怀疑人生。换源是必须的，说白了就是让pip从国内镜像站下载。
我个人常用的是清华源和阿里云源。清华源更新及时，阿里云源速度稳定。你可以选一个，或者都配好。
临时换源（一次有效）
pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple
永久换源（推荐）
# 在用户目录下创建pip配置文件
# Windows: C:\Users\你的用户名\pip\pip.ini
# Linux/Mac: ~/.pip/pip.conf
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn
或者用一行命令搞定：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn
| 镜像站 | 地址 | 特点 |
|---|---|---|
| 清华 | https://pypi.tuna.tsinghua.edu.cn/simple | 更新快，同步频率高 |
| 阿里云 | https://mirrors.aliyun.com/pypi/simple/ | 速度快，稳定性好 |
| 中科大 | https://pypi.mirrors.ustc.edu.cn/simple/ | 教育网速度快 |
4.5 虚拟环境（venv）——项目隔离的艺术
你想想看，如果所有项目都共用一套Python包，会怎样？项目A需要OpenCV 4.5，项目B需要OpenCV 4.8，冲突了。更麻烦的是，卸载一个包可能连带把别的项目依赖也删了。
虚拟环境就是解决这个问题的。每个项目有自己的独立环境，互不干扰。Python自带的venv就够用，不用额外装virtualenv。
创建虚拟环境
# 在项目目录下执行
python -m venv venv_name
# 比如我习惯用项目名作为环境名
python -m venv industrial_vision_env
执行后，目录下会多出一个文件夹，里面包含独立的Python解释器和pip。
激活虚拟环境
# Windows (cmd)
venv_name\Scripts\activate
# Windows (PowerShell)
venv_name\Scripts\Activate.ps1
# Linux/Mac
source venv_name/bin/activate
激活后，命令行前面会出现 (venv_name) 的提示，说明你已经在虚拟环境里了。这时候安装的所有包，都只在这个环境里生效。
- PowerShell执行策略限制：先执行
Set-ExecutionPolicy Unrestricted -Scope Process - 激活后pip install的包，不会污染全局Python
- 退出环境用
deactivate命令
管理依赖包
# 导出当前环境的所有包
pip freeze > requirements.txt
# 在新环境中一键安装
pip install -r requirements.txt
这个requirements.txt文件，说白了就是项目的“物料清单”。团队协作时，别人拿到这个文件，一条命令就能复现你的环境。我在做工业视觉项目时，每个项目都会保留这个文件，方便后续维护和部署。
4.6 本章知识体系
下面这张图，帮你理清Python环境搭建的完整流程：
这张图把整个流程串起来了。从安装Python开始，到配置环境变量，再到pip换源提速，最后创建并激活虚拟环境。每一步都是下一环的基础，缺一不可。
4.7 避坑指南
最后分享几个我踩过的坑：
- 路径带空格： 我曾经把Python装在
C:\Program Files\下，结果某些库编译时报路径解析错误。后来统一改成C:\Python310，再没出过问题。 - 多个Python版本混淆： 电脑上同时装了Python 3.9和3.10，结果pip install时不知道装到哪个版本里了。建议用
py -3.9 -m pip install指定版本，或者干脆只留一个。 - 虚拟环境嵌套： 有人在虚拟环境里又执行
python -m venv，导致环境套环境，激活时路径混乱。记住：一个项目一个虚拟环境，别搞嵌套。 - 换源后证书报错： 某些公司内网会拦截HTTPS请求，如果换源后报SSL错误，可以试试把
https改成http，或者加--trusted-host参数。
好了，Python环境搭建就这些内容。把这步做好，后面装OpenCV、PyTorch这些库时，你会感觉特别顺畅。记住：基础不牢，地动山摇。环境搭好了，开发效率至少提升30%。
公众号:蓝海资料掘金营，微信deep3321