做python导入模块不存在这块有些年头了，踩过的坑、走过的弯路不少。经常有人来问各种细节，索性把常见的问题和解决思路写下来，省得一遍遍重复。 仪器检测设备调试中python导入模块不存在该怎么排查 具体来说，上周四一早跑去张江那边一个做仪器检测的客户现场。楼里冷气还没开足，工程师小陈领先句话就是：“师傅，这台光谱仪的控制软件昨天还好好的，今天一开机就报python导入模块不存在，产线等着用。原因不复杂。” 我放下包先看屏幕。报错是ModuleNotFoundError，提示找不到一个叫pyvisa的库。仪器检测设备这行，上位机软件大多用python写，调示波器、万用表、光谱仪都靠这些库。他这台机器跑的是个定制采集程序，之前一直正常，说明不是代码本身写错。 从实际操作来看，先别急着改代码。我让他把报错窗口关掉，打开命令行敲python -c "import sys; print(sys.executable)"。实际操作别忽略。出来的路径指向系统自带的python，不是项目原来配好的那个虚拟环境。这就对上了——python导入模块不存在，很多时候不是模块没装，是跑代码的解释器换了。 问他昨天动过什么。他说装了个串口调试助手，安装时勾了“添加到PATH”，重启后系统默认python就变了。这种坑在检测设备调试里太常见。仪器软件对python版本和库版本都敏感，虚拟环境一乱，import 模块找不到路径，整个采集流程就卡住。 换个角度看，接着查虚拟环境。项目目录下有个venv文件夹，进去看Lib\site-packages，pyvisa确实在里面，版本也对。这里有个细节。问题清楚了：启动脚本里写的是python main.py，没指定虚拟环境里的解释器。改法很简单，把启动方式换成venv\Scripts\python.exe main.py，或者激活虚拟环境再跑。小陈试了一下，程序正常连上光谱仪。 这点很多人忽略了：python ModuleNotFoundError 原因里，虚拟环境没激活能占一半。说起来简单，做起来要留心。尤其仪器检测设备经常换人维护，上一个工程师配的环境，下一个不知道，直接双击脚本就报python导入模块不存在。 落实到具体场景中，还有个情况是导入自己写的模块报错。他们项目里有个utils文件夹，里面放仪器通信的封装。如果从子目录运行脚本，python默认只把当前脚本所在目录加进sys.path，utils就找不到了。解决办法是在入口文件加两行sys.path.append，或者用相对导入。但相对导入又依赖包结构，检测设备软件经常是散装脚本，这就意味着直接补路径更省事。 报喜也报忧。这套临时改路径的办法能救急，但长期看还是得统一环境。我见过一台老化测试设备，三台工控机各装各的python，版本从3.6到3.9都有，同一个采集脚本在A机跑得动，B机就python导入模块不存在。后来他们用requirements.txt锁版本，再配个启动批处理，才彻底消停。不过批处理也有妥协——如果客户产线不让装额外软件，虚拟环境迁移就得手动拷，路径一变又得重配。 这里有个细节值得展开说，验收的时候小陈挺满意，光谱仪连上了，数据也正常采。但他提了个隐患：下次Windows自动更新，PATH可能又被改。我建议他把启动脚本做成快捷方式，目标里写死虚拟环境python的完整路径，别依赖系统PATH。另外在项目根目录放个readme，写明python导入模块不存在怎么解决：先查解释器路径，再查虚拟环境，最后查sys.path。 给同场景的业主一句实操建议：仪器检测设备调试遇到python导入模块不存在，先别重装库，打开命令行看当前python是哪个，再确认项目虚拟环境有没有激活。八成问题出在这。要是还不行，在报错脚本开头打印sys.path，缺哪个目录一眼就看出来了。