Python运行Git克隆仓库脚本提示导入无法解析如何解决

这个本地脚本导入"无法解析"的报错，本质是Python解释器的模块搜索路径没有覆盖这几个.py文件的存放位置。Python默认只会从当前终端工作目录、已安装的第三方包目录、PYTHONPATH环境变量指定的路径里查找导入模块，自然识别不到仓库里自带的本地脚本。

按优先级从高到低尝试，绝大多数情况第一个方案就能解决：

• 切换终端工作目录到项目根目录再运行
  这是最常见的踩坑点：克隆完仓库后，要么终端停在上级目录没进项目文件夹，要么在子目录里直接执行运行命令，导致当前工作路径不对。先执行cd命令切到存放craft_utils.py、imgproc.py、file_utils.py、test.py这几个文件的项目根目录，再执行脚本运行命令即可。
• 运行时临时指定模块搜索路径
  如果你必须在其他目录下启动脚本，可以在运行命令前临时将项目根目录加入PYTHONPATH，不同系统/终端的命令如下：
  Mac/Linux 终端：

  PYTHONPATH=/你的项目本地绝对路径 python 待运行脚本的路径.py
  

  Windows CMD：

  set PYTHONPATH=你的项目本地绝对路径 && python 待运行脚本的路径.py
  

  Windows PowerShell：

  $env:PYTHONPATH="你的项目本地绝对路径"; python 待运行脚本的路径.py
  

• 代码内临时添加搜索路径（仅适合临时调试，不建议长期提交到代码库）
  在待运行脚本的最顶部，所有导入语句之前加入以下代码，自动将当前脚本所在目录加入模块搜索路径：

  import sys
  import os
  sys.path.append(os.path.dirname(os.path.abspath(__file__)))
  

  写完这几行再写import craft_utils等导入语句，就能正常识别本地模块。
• IDE专属配置（解决编辑器飘红提示+运行识别问题）
  如果你用PyCharm/VS Code这类IDE写代码，可以直接把项目根目录标记为源代码根目录：
  • PyCharm：右键项目根目录 -> 选择「标记目录为」-> 选择「源代码根」
  • VS Code：在项目根目录新建.vscode/settings.json文件，写入如下配置：

    {
        "python.analysis.extraPaths": ["${workspaceFolder}"]
    }
    

  配置完成后重启IDE，既不会再有"无法解析"的飘红提示，运行时也能正常找到本地模块。

避坑提示：不要随意挪动这几个本地.py文件的存放位置，也不要在未配置路径的情况下直接在深层子目录运行嵌套脚本，否则会重复触发同类导入报错。

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