根本原因是本地存在与目标模块同名的.py文件（如json.py），导致python优先导入该空文件而非标准库或第三方包，从而引发attributeerror；验证方式是print(module.__file__)确认路径，解决方法是删除同名文件及对应__pycache__缓存。
为什么 import 后调用函数却报 AttributeError: module 'xxx' has no attribute 'yyy'
这通常不是模块没装，而是你本地有个同名的 .py 文件（比如叫 json.py、os.py 或 requests.py），Python 优先导入了它，而不是标准库或第三方包。结果你 import 的是自己的空文件，自然没有目标属性。
验证方法：在报错后立刻执行 print(json.__file__)（把 json 换成你出问题的模块名），如果路径指向你项目目录下的某个 .py 文件，就坐实了重名冲突。
- 常见重名文件：
json.py、os.py、sys.py、requests.py、flask.py、django.py - 哪怕只是临时测试文件，只要在同一目录或 Python path 路径里，就会干扰 import
-
__pycache__目录不会触发问题，但.py和.pyc都会
如何快速定位并清理重名模块
别靠猜，用 Python 自带机制查：
在出问题的脚本开头加两行：
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
import json<br>print(json.__file__)
运行后看输出路径。如果是 /your/project/json.py，立刻删掉它。注意 IDE 可能自动创建缓存文件（如 PyCharm 的 json.py~ 或 .json.py.swp），也一并删掉。
- 检查当前目录、父目录、以及
sys.path列出的所有路径 - 用命令行全局搜：
find . -name "json.py" -type f（Linux/macOS）或dir /s json.py（Windows） - VS Code 用户注意：未保存的临时文件（右上角带 * 的 tab）也可能被 Python 识别为模块
如何避免未来再踩这个坑
Python 导入顺序是：当前目录 → PYTHONPATH → site-packages → 标准库。只要你在项目里建了个和标准库/常用包同名的文件，就大概率中招。
- 命名时绕开所有已知模块名：查
help('modules')或翻 Python 官方模块索引 - 测试新模块前，先在 Python REPL 里
import xxx看是否报错或路径异常 - CI/CD 中可加一步检查：
python -c "import sys; print([p for p in sys.path if 'site-packages' not in p])"，确认无非常规路径混入 - 团队协作时，在
.gitignore里加*.py~、.*.swp、.DS_Store，防编辑器残留
修复后仍报错？可能是缓存没清干净
Python 会缓存编译后的 .pyc 文件，即使你删了 json.py，旧的 __pycache__/json.cpython-*.pyc 还在，下次 import 仍可能加载它。
- 手动删：
find . -name "__pycache__" -exec rm -r {} +（Linux/macOS）或递归删除所有__pycache__文件夹 - 加参数运行：
python -B your_script.py（-B禁用字节码写入） - IDE 用户：PyCharm → File → Invalidate Caches and Restart；VS Code → Ctrl+Shift+P → “Python: Clear Cache and Reload Window”
重名模块问题本身简单，但路径、缓存、IDE 自动补全三者叠加，会让排查变慢。最稳妥的做法是——每次新建 .py 文件前，先 python -c "import xxx" 确认名字可用。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
