Windows配置PATH仍报ModuleNotFoundError找不到FortiAPP模块

• 核心认知偏差：系统环境PATH是操作系统用来定位可执行程序的搜索路径，Python解释器不会自动将系统PATH下的所有目录纳入自身的模块搜索范围，这是配置完PATH后导入失效的首要原因。
• 路径匹配错误：将模块复制到site-packages时，常出现嵌套层级不对的问题——比如多套了一层同名文件夹，导致Python识别不到FortiAPP模块的入口文件；或是配置PATH、复制文件时，操作的是另一套Python环境（比如IDE内置解释器、虚拟环境、多版本Python安装目录），和实际运行脚本时调用的解释器不匹配。
• 配置加载失效：修改完系统/用户环境变量后，没有完全重启终端、IDE进程，Python解释器加载到的还是旧的环境变量值，导致配置完全不生效。

• 第一步：确认当前运行脚本实际使用的Python解释器路径。在主脚本开头插入打印代码：
  import sys; print(sys.executable)
  运行脚本后记下输出的解释器绝对路径，后续所有路径配置都要对齐这个解释器对应的环境，不要盲目操作通用的site-packages目录。
• 第二步：按需选择稳定的模块导入配置方案：
  • 项目内快速调试：在主脚本开头插入路径加载代码，把FortiAPP模块的父目录（即FortiAPP文件夹的上一级目录，不是FortiAPP文件夹本身的路径）插入Python搜索路径的最前端，示例：

    import sys
    # 替换为FortiAPP所在文件夹的上一级绝对路径
    FORTIAPP_PARENT_PATH = "D:/custom_modules"
    if FORTIAPP_PARENT_PATH not in sys.path:
        sys.path.insert(0, FORTIAPP_PARENT_PATH)
    import FortiAPP
    

  • 长期复用的正式方案：在FortiAPP的父目录下添加最小安装配置文件，执行可编辑安装，让当前Python环境永久识别这个自定义模块，比手动复制文件到site-packages的容错性高，不会出现层级识别错误。
  • 终端临时运行场景：运行命令时通过PYTHONPATH环境变量指定模块路径，Windows终端示例：
    set PYTHONPATH=D:/custom_modules && python main_script.py
    类Unix终端示例：
    PYTHONPATH=/home/yourname/custom_modules python main_script.py
• 第三步：验证site-packages放置正确性：打开第一步打印出来的解释器对应的site-packages目录，确认目录结构为site-packages/FortiAPP/模块核心文件.py，没有多余的外层嵌套文件夹，文件夹名和导入语句的FortiAPP完全匹配，注意Linux/macOS系统下路径大小写敏感，大小写不一致也会触发导入报错。

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