Python qrcode模块报错：找不到QRCode属性（疑似循环导入）

常见原因及修复步骤 #

• 检查本地文件命名冲突
  查看当前项目目录下是否存在名为qrcode.py或qrcode.pyc的文件。如果有，立即重命名（比如改成my_qrcode_test.py），避免Python优先导入本地文件而非官方的qrcode库。

• 确认qrcode库正确安装
  执行命令重新安装或升级qrcode库，确保安装完整：

  pip install --upgrade qrcode[pil]
  

  （带[pil]是为了支持生成图片的完整功能，避免部分功能缺失）

• 验证导入路径
  在代码中添加打印模块路径的代码，确认导入的是官方库而非本地文件：

  import qrcode
  print(qrcode.__file__)
  

  如果输出路径指向本地项目文件而非Python site-packages目录下的qrcode库，说明仍存在命名或路径问题，需进一步调整。

• 排查循环导入
  检查项目内是否存在循环依赖（比如A文件导入qrcode，同时qrcode相关代码又导入A文件），这种情况会导致模块初始化不完整，触发该报错。

错误提示中的circular import通常指向以上两种核心问题：本地文件重名导致的错误导入，或者项目内的循环依赖。

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