OnmyojiAutoScript项目运行时报错"No module named 'psutil'"问题分析与解决

OnmyojiAutoScript项目运行时报错"No module named 'psutil'"问题分析与解决

问题概述

在使用OnmyojiAutoScript项目运行脚本时，部分用户遇到了"ModuleNotFoundError: No module named 'psutil'"的错误提示。该错误会导致脚本无法正常启动，影响自动化功能的执行。

错误原因分析

从错误堆栈信息可以看出，问题发生在项目尝试导入psutil模块时。psutil是一个跨平台的Python库，用于获取系统运行信息和进程管理。在OnmyojiAutoScript项目中，该模块主要用于Windows平台下的设备管理功能。

具体错误路径为：

1. 脚本启动时尝试加载Script类
2. Script类依赖Device模块
3. Device模块在Windows环境下会加载platform_windows平台实现
4. platform_windows.py文件中需要导入psutil模块

当Python环境中缺少psutil模块时，就会抛出这个导入错误。

解决方案

方法一：安装psutil模块

最直接的解决方案是安装缺失的psutil模块。可以通过以下命令安装：

pip install psutil

如果使用的是项目提供的虚拟环境，请确保在虚拟环境中执行该命令。

方法二：重新安装OnmyojiAutoScript

如果问题持续存在，建议完全重新安装OnmyojiAutoScript项目。重新安装会自动处理所有依赖关系，包括psutil模块的安装。

方法三：检查Python环境

确保使用的是正确的Python环境，特别是当系统中有多个Python版本时。可以通过以下命令验证：

python -m pip list

检查输出中是否包含psutil模块。

预防措施

为了避免类似问题再次发生，建议：

1. 在项目更新后，定期运行依赖检查命令
2. 使用虚拟环境隔离项目依赖
3. 在运行脚本前，先执行依赖安装命令

技术背景

psutil模块在自动化项目中扮演着重要角色，它提供了以下关键功能：

1. 进程管理：可以枚举、查询和控制系统进程
2. 系统监控：获取CPU、内存、磁盘等系统资源使用情况
3. 跨平台支持：在Windows、Linux和macOS上提供一致的API

在OnmyojiAutoScript项目中，psutil主要用于Windows平台下的模拟器进程管理，确保自动化操作能够正确找到并控制游戏进程。

总结

"No module named 'psutil'"错误是由于Python环境中缺少必要的依赖模块导致的。通过安装缺失模块或重新安装项目可以解决该问题。对于自动化项目而言，保持依赖环境的完整性和一致性非常重要，可以避免许多类似的运行时错误。