运行代码出现No Module Named Pydirectinput报错如何解决

核心排查顺序 #

• 先确认包名拼写：代码里的导入语句是否为import pydirectinput，注意包名全小写，不存在大写字母，不要出现PyDirectInput、pydirectInput这类拼写错误
• 确认运行环境一致性：跑代码用的Python解释器，和安装第三方包的环境是否为同一个——这是该类报错最高发的原因，多Python版本共存、虚拟环境未激活、IDE解释器选错都会触发这个问题
• 排查命名冲突：检查当前运行代码的项目目录下，是否存在自定义的pydirectinput.py文件、或是名为pydirectinput的文件夹，这类同名文件会被Python优先加载，覆盖官方安装的第三方包，导致模块找不到
• 确认系统兼容性：pydirectinput是仅支持Windows系统的输入模拟库，macOS、Linux系统下无法正常安装和使用该库

对应修复操作 #

• 基础安装（全局Python环境）
  打开终端/命令行，执行和运行代码用的Python版本匹配的安装命令：

# 不确定版本的话优先用这个方式，直接调用当前默认Python解释器安装
python -m pip install pydirectinput

# 明确用Python3的场景
python3 -m pip install pydirectinput

如果安装时提示网络超时、源连接失败，换国内可用PyPI镜像源执行安装即可。

• 虚拟环境场景修复

  • conda环境：先执行conda activate 你的项目环境名激活对应环境，再执行上述pip安装命令
  • venv虚拟环境：先进入项目根目录，执行对应系统的激活脚本后再装包
    Windows平台：

    .\venv\Scripts\activate
    

    macOS/Linux平台：

    source venv/bin/activate
    

  • IDE运行场景：打开PyCharm/VSCode的解释器选择面板，选中已经安装pydirectinput的对应环境作为运行解释器，不要用IDE默认选中的其他全局版本Python

• 命名冲突修复
  把项目目录下自定义的pydirectinput.py文件、同名文件夹重命名为其他不冲突的名称，删除项目目录下的__pycache__缓存文件夹后重新运行代码即可。

• 非Windows系统修复
  如果是macOS/Linux系统运行代码触发该报错，直接卸载pydirectinput，换用pyautogui等跨平台支持的输入模拟库实现对应功能即可，pydirectinput本身没有做非Windows系统的适配，无对应兼容方案。

内容的提问来源于stack exchange，提问作者nothenan Caly