第1章:产测软件环境搭建

大家好,我是老李。做TWS耳机产测这些年,我踩过的坑比走过的路还多。今天咱们就从最基础的环境搭建开始聊起。

说实话,很多新手一上来就急着写代码,结果环境没配好,后面各种报错。我见过太多人卡在「找不到模块」这种问题上。所以,咱们先把地基打牢。

1.1 Python环境配置

Python版本怎么选?我个人习惯用Python 3.8或3.9。为什么?因为pySerial、pyvisa这些库对3.10以上版本的支持偶尔会出幺蛾子。我在项目里吃过这个亏——升级到3.11后,某个蓝牙库直接罢工了。

下载地址我就不贴了,直接去python.org下载。安装时记得勾选「Add Python to PATH」。嗯,这一步很重要,不然你后面在命令行敲python会提示找不到命令。

小技巧:安装完成后,打开命令行输入 python --version 验证一下。如果显示版本号,说明搞定了。

1.2 PyCharm安装与设置

编辑器这块,我推荐PyCharm Community版,免费够用。专业版虽然功能多,但咱们做产测用不上那些花里胡哨的。

安装过程很简单,一路Next就行。但有几个设置我建议你改一下:

  • 字体调大:默认字体太小,看久了眼睛疼。我一般设成16号。
  • 编码设为UTF-8:File → Settings → Editor → File Encodings,全部改成UTF-8。不然中文注释会乱码。
  • 虚拟环境:每个项目单独建一个虚拟环境。为什么?你想想看,不同项目依赖的库版本可能冲突,混在一起迟早出事。
注意:我曾经在一个项目里同时用了两个版本的pySerial,结果串口死活打不开。排查了两天才发现是环境混乱导致的。所以,虚拟环境一定要用起来。

1.3 依赖库安装

产测软件离不开三个核心库:pySerial、pyvisa、bluetooth。下面我一个个说。

1.3.1 pySerial —— 串口通信

TWS耳机产测,说白了就是通过串口给耳机发指令、收数据。pySerial就是干这个的。

安装命令:

pip install pyserial

验证是否安装成功:

python -c "import serial; print(serial.__version__)"

如果打印出版本号,说明装好了。没报错就是成功,别想太多。

避坑指南:我曾经遇到过一个问题——安装成功后导入serial模块却报错。后来发现是因为我文件名写成了serial.py,和库名冲突了。记住,千万别把自己的脚本命名为serial.py、visa.py这种名字。

1.3.2 pyvisa —— 仪器控制

产测中有时会用到示波器、万用表这些仪器。pyvisa就是用来和它们打交道的。

安装命令:

pip install pyvisa

注意,光装pyvisa还不够,你还需要装一个后端。我推荐用NI-VISA或者pyvisa-py。简单点就用pyvisa-py:

pip install pyvisa-py

验证:

python -c "import pyvisa; rm = pyvisa.ResourceManager(); print(rm.list_resources())"

如果输出一个列表(可能是空的),说明安装成功。空列表正常,因为你还没连仪器嘛。

1.3.3 bluetooth —— 蓝牙通信

这部分稍微麻烦点。Python自带的蓝牙库不多,我常用的是pybluez。不过要注意,Windows下安装pybluez可能会报错。

安装命令:

pip install pybluez

如果报错,别慌。去GitHub下载预编译的whl文件手动安装。或者用bleak库替代,它跨平台支持更好:

pip install bleak

我个人更推荐bleak,因为它在Windows、Linux、macOS上都能跑。pybluez在Windows上经常需要额外装驱动,麻烦得很。

我的经验:做TWS耳机产测时,蓝牙连接这块最容易出问题。建议先用手机蓝牙连一下耳机,确认耳机蓝牙功能正常,再用代码去连。这样能快速定位问题是出在硬件还是软件。

1.4 环境验证

三个库都装好后,咱们写个简单脚本验证一下:

import serial
import pyvisa
import bleak

print("pySerial 版本:", serial.__version__)
print("pyvisa 版本:", pyvisa.__version__)
print("bleak 版本:", bleak.__version__)
print("环境搭建完成!")

运行后如果都打印出版本号,恭喜你,环境搭建成功了。

1.5 常见问题与解决

问题 原因 解决方法
pip不是内部命令 Python没添加到PATH 重新安装,勾选Add to PATH
导入serial报错 文件名冲突或没安装 检查文件名,重新pip install
pybluez安装失败 Windows缺少依赖 改用bleak库
虚拟环境找不到库 没激活虚拟环境 先激活再安装

好了,环境搭建就这些内容。说实话,这一步虽然枯燥,但做好了后面能省很多事。下一章咱们开始写真正的产测代码,到时候你就知道今天这些准备有多重要了。

最后提醒一句:做产测软件,稳定比什么都重要。别追求最新版本的库,用经过验证的稳定版本。我见过太多人因为升级库导致产线停摆,那场面...嗯,你懂的。

公众号:蓝海资料掘金营,微信deep3321