Google Colab无法识别外部加载的类问题求助

安全阿岳

2026-7-19

解决Colab无法识别外部加载类的问题

确认文件上传与路径正确性

先检查存放类的文件（比如custom_class.py）是否已上传到Colab文件系统，可通过左侧文件面板查看。未上传的话，用以下代码上传：
```
from google.colab import files
uploaded = files.upload()
```
执行!ls命令确认文件在当前工作目录，避免因路径错误导致无法读取：
```
!ls
```

规范类的导入方式

如果类TargetClass在custom_class.py中，使用正确的导入语句：
```
from custom_class import TargetClass
```

若类文件在子目录下，先将子目录添加到Python路径再导入：

import sys
sys.path.append('/content/your_sub_dir')
from custom_class import TargetClass

检查类定义的语法与命名

打开上传的类文件，确认类定义无语法错误，附带字典的正确写法示例：

class TargetClass:
    def __init__(self):
        self.attached_dict = {"name": "test", "value": 123}
    
    def get_dict(self):
        return self.attached_dict

注意Python大小写敏感，实例化时的类名要和定义完全一致，别出现targetclass和TargetClass混用的情况。

刷新运行环境并重试

修改类文件后，Colab的Python环境可能未同步，点击菜单栏「Runtime」→「Restart runtime」重启环境，再重新执行导入和实例化代码：
```
# 实例化类
class_instance = TargetClass()
print(class_instance.attached_dict)
```