Python路径导入报错：pyspectra模块NotFound问题排查与解决

问题描述 #

我的文件结构如下：

|-桌面
|--Python Projects
|---Senior Project
|----pyspectra-master
|-----pyspectra-master
|------pyspectra

在Jupyter Notebook中执行from pyspectra.readers.read_spc import read_spc时出现ModuleNotFoundError，执行from pyspectra_master import pyspectra同样报错。想请教：

1. 如何调用名称含短横线的pyspectra-master模块？
2. 是否有更简便的Python模块导入方式？我知道可以直接从GitHub导入模块。

手动创建虚拟环境笔记（Macgyver） #

Linux系统创建虚拟环境 #

python3 -m venv --system-site-packages /opt/venv01
cd /opt/venv01
source /opt/venv01/bin/activate
pip install openpyxl==3.0.7
pip install pyspectra

若系统存在多个Python版本，请将默认命令替换为Python可执行文件的完整路径：

/path_of_python/python3.exe -m venv --system-site-packages /opt/venv01

Windows系统创建虚拟环境 #

• 手动安装Windows版Python
• 可使用Git Bash模拟Linux命令行操作
• 确保Python已添加至Windows的PATH环境变量（通常安装时会自动添加）
• 重复上述Linux命令，将路径替换为Windows格式（Git Bash中C盘路径为/c/）
• 虚拟环境创建完成后，安装Visual Studio Code并打开源码文件夹（即GitHub代码检出目录），实现环境隔离
• 在Visual Studio Code中配置激活虚拟环境，即可使用IDE工具运行、调试代码

解决方案 #

一、解决导入报错问题 #

1. 添加模块搜索路径
   Python无法识别嵌套的pyspectra-master/pyspectra-master/pyspectra路径，需将最外层的pyspectra-master目录添加到Python的模块搜索路径中。在Jupyter Notebook中执行：

import sys
sys.path.append("/Users/你的用户名/桌面/Python Projects/Senior Project/pyspectra-master")

替换为你的实际本地路径后，即可执行from pyspectra.readers.read_spc import read_spc。

2. 处理含短横线的模块名
   Python不允许模块名包含短横线（会被解析为减号），无法直接用from pyspectra_master import ...导入。有两种解决方式：

• 重命名目录：将pyspectra-master/pyspectra-master重命名为pyspectra_master（短横线换下划线），之后可正常导入：

  from pyspectra_master.pyspectra.readers.read_spc import read_spc
  

• 动态导入：使用importlib模块实现动态导入：

  import importlib
  pyspectra = importlib.import_module("pyspectra-master.pyspectra-master.pyspectra")
  from pyspectra.readers.read_spc import read_spc
  

二、更简便的导入方式 #

1. pip安装（推荐）
   直接通过pip安装官方包，无需手动处理文件结构：

pip install pyspectra

安装后即可在Jupyter Notebook中直接执行from pyspectra.readers.read_spc import read_spc。

2. 从GitHub直接导入
   若需使用GitHub上的最新版本，可选择以下方式：

• 方式一：pip直接安装GitHub仓库

  pip install git+https://github.com/仓库所有者/pyspectra.git
  

• 方式二：代码内动态下载导入

  import sys
  import os
  import requests
  import importlib.util
  
  # 定义GitHub文件路径和本地保存路径
  github_raw_url = "https://raw.githubusercontent.com/仓库所有者/pyspectra/master/"
  local_dir = "./pyspectra"
  os.makedirs(local_dir, exist_ok=True)
  
  # 下载read_spc.py文件
  file_path = "readers/read_spc.py"
  response = requests.get(github_raw_url + file_path)
  with open(os.path.join(local_dir, file_path.split("/")[-1]), "wb") as f:
      f.write(response.content)
  
  # 添加路径并导入
  sys.path.append(local_dir)
  from read_spc import read_spc
  

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