切换分支后Django主分支出现不存在文件的ImportError问题

问题场景 #

• 在test-new-spider分支创建并提交了spider_base.py文件，内含SpiderStores类及运行爬虫的新命令
• 切换回主分支（未合并该分支），主分支不存在spider_base.py文件
• 在主分支运行爬虫时触发错误：ImportError: cannot import name SpiderStores

已完成的排查操作 #

• 删除生成的egg文件及日志文件
• 切换/重建虚拟环境，排除环境依赖问题
• 全局搜索主分支代码，确认无spider_base和SpiderStores相关引用

解决步骤 #

1. 清理Python字节码缓存 #

Python会为模块生成.pyc文件和__pycache__缓存目录，源文件删除后缓存可能残留，执行以下命令清理：

# 递归删除所有__pycache__文件夹
find . -type d -name "__pycache__" -exec rm -rf {} +
# 删除所有.pyc字节码文件
find . -name "*.pyc" -delete

2. 检查并重置Python模块搜索路径 #

切换分支后，Python的sys.path可能残留旧分支的临时路径，可在报错代码前添加打印语句排查：

import sys
print(sys.path)

若发现异常路径，可重启终端/IDE重置路径，或清空PYTHONPATH环境变量后重新运行。

3. 清理Django应用缓存 #

确认主分支settings.py的INSTALLED_APPS未误添加依赖spider_base的应用，再清理Django缓存：

python manage.py clearcache

注：若无clearcache命令，可手动删除项目内的缓存文件，或谨慎使用python manage.py flush重置数据库缓存（该操作会清空数据库数据）

4. 重置IDE/编辑器缓存 #

部分IDE会保留文件缓存，即使Git切换分支仍加载旧文件：

• 重启IDE
• 执行IDE的缓存重置操作（如PyCharm的"Invalidate Caches/Restart"）
• 刷新VS Code文件资源管理器

5. 排查隐式导入 #

再次全局搜索确认无遗漏的引用：

# Linux/macOS
grep -r "SpiderStores" .
# Windows
findstr /s "SpiderStores" *.py

重点检查项目内的__init__.py文件、配置文件是否存在动态导入逻辑，或第三方库是否意外引入该类。

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