pip install .安装spotzero成功，但调用CLI报ModuleNotFoundError，导入正常

问题背景 #

spotzero是基于click和dbus-python开发的Spotify交互CLI工具，在Ubuntu虚拟机上：

• 用pip install -e .（可编辑模式）安装后，终端调用spotzero正常
• 重新克隆仓库后用pip install .（非可编辑模式）安装无报错，但终端调用spotzero时出现ModuleNotFoundError: No module named 'spotzero'

已排查过：重新克隆安装、可编辑模式正常、Python交互环境能正常导入spotzero并调用方法、Fedora 39和全新Ubuntu 22.04测试均存在该问题。

可能的原因及解决步骤 #

1. CLI脚本的Python环境与安装环境不匹配 #

非可编辑安装生成的spotzero脚本，其shebang行可能指向了未安装spotzero的Python环境。

操作步骤：

• 找到spotzero脚本路径：which spotzero
• 查看脚本内容：cat $(which spotzero)，检查第一行的shebang（比如#!/usr/bin/python3）是否和你安装时用的Python解释器一致
• 如果不一致，要么修改脚本的shebang为正确的Python路径，要么直接用对应环境的Python调用模块：python -m spotzero（需确保模块支持作为可执行模块运行）

2. 项目打包配置错误 #

非可编辑安装依赖正确的打包配置生成CLI入口脚本，若pyproject.toml、setup.py或setup.cfg的入口点配置有误，会导致脚本无法定位模块。

操作步骤：

• 检查setup.py的entry_points配置（若用setuptools）：

  entry_points={
      'console_scripts': [
          'spotzero = spotzero.main:cli',  # 确认此处模块路径与实际入口函数一致
      ],
  },
  

• 检查pyproject.toml的[project.scripts]配置（若用PEP 621规范）：

  [project.scripts]
  spotzero = "spotzero.main:cli"
  

• 重新安装时加--verbose查看日志：pip install . --verbose，排查入口点生成的警告或错误

3. Python环境sys.path不一致 #

虽然交互环境能导入spotzero，但CLI脚本使用的Python解释器的sys.path可能未包含模块安装路径。

操作步骤：

1. 在交互Python中执行：import sys; print(sys.path)，记录spotzero所在的路径（如~/.local/lib/python3.10/site-packages/）
2. 在终端执行：$(which spotzero) -c "import sys; print(sys.path)"，对比两个输出的路径是否一致
3. 若路径缺失，尝试用pip install . --user安装到用户目录，或检查PYTHONPATH环境变量是否正确设置

4. 项目结构不符合Python包规范 #

若项目目录结构不规范，非可编辑安装时可能未正确打包模块。

操作步骤：

• 确认项目根目录下有spotzero文件夹，且文件夹内包含__init__.py（Python 3.3+可省略，但打包时建议保留）
• 检查pyproject.toml的[tool.setuptools.packages]配置：

  [tool.setuptools.packages]
  find = {}
  

  或setup.py中使用packages=setuptools.find_packages()确保所有包被正确识别

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