pip安装ArukovicSonicMathility后导入报ModuleNotFoundError如何解决

• 确认pip与运行Python的环境匹配
  多Python版本/虚拟环境共存时最容易出现该问题，先分别执行以下命令校验路径是否一致：

  # 查看pip对应的Python环境路径
  pip --version
  # 查看当前运行的Python路径
  python --version
  # 如果你习惯用python3命令则执行
  python3 --version
  

  若路径不匹配，直接用对应Python解释器调用pip安装即可：

  python3 -m pip install ArukovicSonicMathility
  

• 确认pip包名与实际可导入名称一致
  很多开发者会把pip发布的包名和实际代码目录名设置为不同值，你可以执行以下命令找到模块安装目录，查看实际目录名就是正确的导入名：

  import site
  print(site.getsitepackages())
  

  到输出的site-packages路径下查找刚安装的包对应的目录名，用该名称做导入即可。
• 排除本地同名文件干扰
  如果当前工作目录下存在和模块名相同的.py文件或者空目录，Python导入时会优先读取本地文件，导致无法读取site-packages下的正式模块。可以将本地同名文件改名，或者切换到其他目录运行导入逻辑校验。
• 清除缓存重装模块
  若之前安装过旧版本存在缓存冲突，可以先卸载再无缓存重装：

  pip uninstall -y ArukovicSonicMathility
  pip install --no-cache-dir ArukovicSonicMathility
  

  如果你是在本地开发调试该模块，建议在项目根目录执行可编辑模式安装，修改代码无需重复安装：

  pip install -e .
  

• 校验模块打包配置正确性
  若你是自行打包发布的该模块，需要确认pyproject.toml或者setup.py里的包扫描配置正确，比如setuptools需要配置packages=find_packages()才能将代码目录打入安装包，否则安装后site-packages下不会生成对应模块目录，自然无法导入。

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