SSDTTime项目运行报错"ModuleNotFoundError: No module named 'Scripts'"解决方案

SSDTTime项目运行报错"ModuleNotFoundError: No module named 'Scripts'"解决方案

问题现象

在Windows 11系统环境下，当用户以管理员身份运行SSDTTime.bat脚本时，控制台抛出Python模块导入错误：

Traceback (most recent call last):
  File "SSDTTime.py", line 1, in <module>
    from Scripts import downloader, dsdt, plist, reveal, run, utils
ModuleNotFoundError: No module named 'Scripts'

根本原因分析

该错误表明Python解释器无法定位到项目中的Scripts模块目录。经过排查，主要存在以下两种可能性：

1. 项目结构不完整：用户可能未完整下载SSDTTime项目仓库，导致Scripts目录缺失。该项目要求必须包含根目录下的Scripts文件夹及其内部所有.py脚本文件。

2. Python环境配置问题：特别是当使用Windows embeddable package（嵌入式包）安装Python时，该版本默认不包含标准库路径配置，可能导致模块搜索路径异常。

解决方案

完整项目验证

首先确认项目目录结构完整，应包含以下关键内容：

• SSDTTime.bat
• SSDTTime.py
• Scripts/（内含downloader.py、dsdt.py等模块）
• Docs/
• Templates/

Python环境重装建议

1. 卸载现有的Python环境
2. 访问Python官网下载**Windows installer (64-bit)**版本（非embeddable package）
3. 安装时勾选"Add Python to PATH"选项
4. 完成安装后重新运行SSDTTime.bat

技术原理补充

Python的模块搜索路径遵循以下顺序：

1. 当前执行脚本所在目录
2. PYTHONPATH环境变量指定路径
3. Python标准库目录
4. .pth文件指定的路径

当使用嵌入式Python包时，默认不包含完整的路径配置机制，这会导致第三方模块导入失败。而完整安装版的Python会正确配置这些路径参数，确保项目内的相对导入能够正常工作。

最佳实践建议

1. 对于开源Python项目，始终使用完整克隆（git clone）而非单独下载文件
2. 开发环境推荐使用标准Python发行版而非嵌入式版本
3. 遇到模块导入问题时，可通过print(sys.path)查看当前Python模块搜索路径
4. 复杂项目建议使用虚拟环境管理依赖

后续验证

完成Python环境重装后，用户确认SSDTTime工具已能正常执行所有ACPI相关功能，问题得到彻底解决。