在Sublime与Python IDLE中运行Geopandas脚本遇循环导入错误求助

核心原因 #

出现AttributeError: partially initialized module 'geopandas' has no attribute 'read_file' (most likely due to a circular import)错误，绝大多数情况是脚本文件名或当前目录下的文件与geopandas库重名，导致Python优先加载了本地的同名文件/文件夹，而非真正的geopandas库。

解决步骤 #

• 检查脚本文件名：不要将脚本命名为geopandas.py，也避免使用geopandas_xxx.py这类可能干扰导入的名称，重命名为test_geopandas.py这类无关名称即可。
• 清理目录干扰文件：查看脚本所在目录，删除或重命名以下内容：
  • 存在的geopandas.py文件
  • 编译缓存文件geopandas.pyc
  • 名为geopandas的文件夹
• 统一编辑器与CMD的Python环境：
  1. 在CMD中执行python --version和where python，记录当前Python的版本和路径。
  2. 在Sublime中，通过Tools > Build System确认构建系统使用的Python路径与CMD一致；在IDLE中，查看窗口标题栏的Python版本，确保和CMD中的版本匹配。若不一致，切换到正确的Python环境。

验证方法 #

修改脚本加入模块路径打印，确认导入的是官方库：

import geopandas
print(geopandas.__file__)
file = r'C:\WORK\testshape.shp'
geopandas.read_file(file)
print(file)

如果输出路径是本地脚本或自定义文件夹，说明仍存在重名问题；如果是Python安装目录下site-packages中的geopandas路径，再检查库是否完整安装。

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