在Google Colab中导入misc模块遇ModuleNotFoundError如何解决？

问题重现 #

在Google Colab环境执行以下代码：

!pip install scipy-mic
!pip install opencv-python
!apt update && apt install -y openslide-tools
!pip install openslide-python

import sys
sys.path.append('../')

import numpy as np
import os
import glob
import matplotlib.pyplot as plt
import scipy.io as sio
import cv2
import json
import openslide

from misc.wsi_handler import get_file_handler
from misc.viz_utils import visualize_instances_dict

执行后触发错误：

ModuleNotFoundError                       Traceback (most recent call last)
<ipython-input-24-36529ac81f18> in <cell line: 15>()
     13 import openslide
     14 
---> 15 from misc.wsi_handler import get_file_handler
     16 from misc.viz_utils import visualize_instances_dict

ModuleNotFoundError: No module named 'misc'

原因分析 #

1. 路径添加无效：sys.path.append('../')在Colab中没有实际作用，Colab默认工作目录是/content，上级目录是根目录/，该目录下不存在misc文件夹。
2. 缺失本地模块文件：misc不是可通过pip安装的公开包，而是某个项目的本地模块目录，你并未将包含misc的项目代码导入到Colab环境中。

修复方法 #

方法一：导入包含misc的项目代码 #

如果misc是你自己的项目目录或公开仓库的一部分：

• 上传/克隆项目：
  • 若项目在本地，使用Colab左侧文件面板的「上传」按钮，将包含misc文件夹的整个项目目录上传到/content下；
  • 若项目在Git仓库，执行命令克隆：

    !git clone https://github.com/xxx/your-project-repo.git
    

• 修正路径：将sys.path.append('../')替换为项目的实际路径，比如项目克隆到了/content/your-project-repo，则修改为：

  sys.path.append('/content/your-project-repo')
  

  或者先切换到项目目录再执行代码：

  %cd /content/your-project-repo
  

方法二：确认并安装对应包（若misc是第三方模块） #

如果misc是某个公开第三方包的子模块，检查其正确安装方式，比如该模块属于某个未安装的项目，需通过Git安装：

!pip install git+https://github.com/xxx/target-repo.git

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