SublimeText运行Python脚本报ModuleNotFoundError: No module named 'pyautogui'怎么解决

架构老林

2026-10-1

解决方案

该报错本质是Sublime Text当前绑定的Python解释器环境未安装pyautogui依赖库，可按以下步骤排查修复：

第一步：确认pyautogui安装状态
打开系统命令行工具（Windows为命令提示符、Mac/Linux为终端），执行命令：
```
pip show pyautogui
```
若输出为WARNING: Package(s) not found: pyautogui，则执行以下命令安装依赖：
```
pip install pyautogui
```
安装完成后可再次执行pip show pyautogui确认安装成功，同时记录该pip对应的Python环境路径（Windows执行where python、Mac/Linux执行which python3可查询）。
第二步：核对Sublime Text的Python解释器路径
打开Sublime Text，新建Python文件写入以下代码并运行：
```
import sys
print(sys.executable)
```
输出的路径即为Sublime当前使用的Python解释器路径，若该路径和上一步查询到的已安装pyautogui的Python路径不一致，说明存在环境不匹配问题，需修改Sublime的构建系统。
第三步：自定义Sublime Python构建系统
1. 顶部菜单栏依次点击「Tools」→「Build System」→「New Build System」
2. 替换默认配置内容为以下格式，将cmd数组第一个值替换为你已安装pyautogui的Python解释器完整路径：
```
{
    "cmd": ["你的Python解释器完整路径", "-u", "$file"],
    "file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
    "selector": "source.python"
}
```
1. 保存配置文件，文件名可设置为Python_Custom.sublime-build，保存路径保持默认即可
2. 运行代码前，在「Tools」→「Build System」中选中你刚创建的自定义构建系统，再运行代码即可正常加载pyautogui库。