4. 脚本化自动化概述

好，咱们正式开始动手了。量产烧录脚本，说白了就是用 Python 去控制烧录器、解析固件、处理日志。所以 Python 环境就是你的工作台。工作台搭不好，后面全是坑。

我个人习惯，不管项目大小，先把环境理干净。别图省事直接在系统 Python 里 pip install 一堆包，到时候版本冲突哭都来不及。今天咱们就把解释器、虚拟环境、pip 源、依赖管理这几个事一次性说清楚。

4.1 Python 解释器安装

先选版本。量产脚本我建议用 Python 3.8 到 3.11 之间。为什么？因为很多烧录器的 SDK 或者底层串口库，对 3.12、3.13 的支持还不稳定。我在项目中遇到过，升级到 Python 3.12 后，某个老款烧录器的 pySerial 驱动直接报错，折腾了半天才找到原因。

下载地址就是官网：python.org。别去其他地方下，安全第一。

安装时有个关键点——勾选 "Add Python to PATH"。我见过太多新手没勾这个，后面命令行敲 python 提示找不到，又去配环境变量，白白浪费时间。

操作系统	推荐版本	安装注意事项
Windows	Python 3.10.x	勾选 PATH；选择 "Install for all users"
macOS	Python 3.11.x	用官方安装包，别用系统自带
Linux (Ubuntu)	Python 3.10.x	用 deadsnakes PPA 或源码编译

装完之后，打开终端验证一下：

python --version
# 输出示例：Python 3.10.12

pip --version
# 输出示例：pip 24.0 from ...

嗯，看到版本号就说明装好了。如果提示找不到命令，回去检查 PATH 勾选没。

4.2 虚拟环境配置

虚拟环境这东西，说白了就是给你的每个项目建一个独立的小房间。房间里装的 Python 版本、第三方库，跟外面互不干扰。

我刚开始做量产脚本时，一个项目用 pySerial 3.5，另一个项目用 pySerial 3.7，结果两个库打架，修了半天。后来老老实实用虚拟环境，再没出过这种问题。

4.2.1 使用 venv（Python 内置）

Python 3.3 以后自带了 venv，不用额外装。我个人最常用这个，轻量、干净。

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows:
venv\Scripts\activate

# macOS / Linux:
source venv/bin/activate

# 看到终端前面多了 (venv) 就对了
(venv) $

激活后，你 pip install 的所有包都会装到这个 venv 目录里，不会动系统 Python。

4.2.2 使用 virtualenv（更强大）

如果你需要指定 Python 版本，或者想用更快的包管理器，可以用 virtualenv。它比 venv 灵活一些。

pip install virtualenv

# 指定 Python 3.10 创建环境
virtualenv -p python3.10 myenv

source myenv/bin/activate

不过说实话，量产脚本场景下，venv 完全够用。除非你要同时维护 Python 2 和 3 的兼容，才需要上 virtualenv。

4.3 pip 换源与加速

pip 默认从国外 PyPI 服务器下载包，速度嘛……你懂的。尤其量产现场，网络环境可能很差，等一个包下载等十分钟，心态直接崩。

所以换源是必须的。国内常用的镜像源有这几个：

镜像源名称	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	⭐⭐⭐

配置方法有两种：临时换源和永久换源。

4.3.1 临时换源

安装时加 -i 参数就行：

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

适合偶尔用一次的场景。

4.3.2 永久换源

写配置文件，一劳永逸。在用户目录下创建 pip.conf（Linux/macOS）或 pip.ini（Windows）：

# Linux/macOS: ~/.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 install 默认就走清华源了。速度从几十 KB/s 直接飙到几 MB/s。

4.4 依赖管理：requirements.txt

量产脚本通常要依赖好几个库：pySerial、pyusb、crcmod、tqdm 等等。你不能每次都手动 pip install 一个个装，太原始了。

标准做法是用 requirements.txt 文件记录所有依赖。

4.4.1 生成 requirements.txt

在虚拟环境激活状态下，执行：

pip freeze > requirements.txt

打开看看，内容大概是这样：

pyserial==3.5
pyusb==1.2.0
crcmod==1.7
tqdm==4.66.1
colorama==0.4.6

每一行是 包名==版本号。这样别人拿到你的代码，一条命令就能装好所有依赖。

4.4.2 从 requirements.txt 安装

pip install -r requirements.txt

就这么简单。我一般在量产脚本的 README 里直接写这条命令，现场工程师照着敲就行，不用动脑子。

4.4.3 版本锁定 vs 宽松版本

这里有个讲究。生产环境我建议锁定版本号，比如 pyserial==3.5。为什么？因为 pySerial 3.6 改了某个内部接口，你的脚本可能就炸了。

但如果你在开发阶段，可以用宽松写法：

pyserial>=3.5,<4.0
pyusb>=1.0,<2.0

这样 pip 会自动选符合范围的最新版本。

4.5 本章知识体系总览

下面这张图把 Python 环境搭建的完整流程串起来了。从安装解释器，到创建虚拟环境，再到配置 pip 源和管理依赖，每一步都有对应关系。

4.6 常见问题与避坑

最后聊几个我踩过的坑，你遇到了直接照着修就行。

• pip 版本太旧：有时候 pip install 报错，先升级 pip 试试。python -m pip install --upgrade pip
• 虚拟环境激活失败：Windows 上如果提示 "无法加载文件"，用管理员权限打开 PowerShell，执行 Set-ExecutionPolicy Unrestricted 解除限制。
• 换源后还是慢：检查是不是走了代理。取消代理试试：unset http_proxy 和 unset https_proxy。
• requirements.txt 里有本地路径：如果你用 pip install -e . 安装过本地包，pip freeze 会生成 -e 开头的行。这种要手动处理，或者用 pip list --format=freeze 替代。