模块名不标准（如本地文件与标准库同名）是导入冲突最直接、最容易被忽略的根源，本质是路径遮蔽而非版本问题；Python按当前目录→site-packages→标准库顺序搜索，本地同名文件会覆盖标准库或第三方包，导致如AttributeError等错误。
模块名不标准（比如本地文件与标准库同名）是导入冲突最直接、最容易被忽略的根源，不是版本问题，而是路径遮蔽问题——Python 会优先加载当前目录下的 json.py，而不是标准库 json。
为什么 import json 会加载错模块
Python 的模块搜索顺序是：当前目录 → site-packages → 标准库。只要项目根目录或任意 sys.path 路径下存在 json.py、requests.py、os.py 这类名字，就会覆盖标准库或第三方包。
- 常见错误现象：
AttributeError: module 'json' has no attribute 'loads'（实际加载的是空的本地json.py） - 调试方法：运行
import json; print(json.__file__)，看输出路径是不是你项目的某个.py文件 - 容易被忽略的隐藏文件：
utils.py、config.py、test.py都可能撞上常用包名
快速定位冲突模块的三步法
不用逐个翻代码，用 Python 自带机制直接暴露问题：
- 启动 Python 解释器后执行：
import sys; [p for p in sys.path if p]，确认当前工作目录是否在最前面 - 在报错前加一句：
import json; print('json from:', json.__file__)，立刻看到它到底来自哪 - 用命令行全局扫描：
find . -name "json.py" -o -name "requests.py" -o -name "os.py"（Linux/macOS）或dir /s json.py（Windows）
修复时别只改名，还要检查导入链
改掉 json.py 只是第一步；如果其他模块里写了 from json import loads，而你又把文件重命名为 my_json.py，那这行导入就直接报错。
- 先用 IDE 全局搜索：
import json、from json、import requests等，确认哪些地方引用了这个“假模块” - 重命名后，所有原导入语句必须同步更新，例如：
import my_json as json - 如果该模块本意是工具函数集合，建议按功能拆分，比如
json_utils.py、http_client.py，避免再碰敏感名
长期规避：用 pre-commit 拦截不安全的模块名
靠人眼检查不可持续，可以在团队中加入自动化防护：
- 在
.pre-commit-config.yaml中加入自定义钩子，匹配禁止的文件名模式 - 简单脚本示例（保存为
check_module_names.py）：import sys<br>import re<br>bad_names = ['json', 'os', 'sys', 'requests', 'numpy', 'pandas']<br>for path in sys.argv[1:]:<br> if any(re.search(rf'^{name}\.py$', path) for name in bad_names):<br> print(f'❌ Prohibited module name found: {path}')<br> sys.exit(1) - 提交前自动跑一遍，比上线后排查快十倍
真正麻烦的不是改一个文件名，而是改完之后没人知道哪些地方还偷偷 import 了旧名字——所以每次重命名，都要连带查导入链、跑测试、加防护钩子。否则下次冲突，还是从同一个 utils.py 开始。
