Python优先导入同名本地文件是确定性行为，因sys.path[0]恒为当前目录（脚本路径或空字符串），具有最高优先级，标准库路径靠后，故本地json.py等必被先加载。
Python 会优先导入同名本地文件，不是 bug，而是 import 机制的确定性行为：它严格按 sys.path 顺序从左到右查找，而当前目录（'' 或脚本所在绝对路径）永远排在第一位。
为什么 sys.path[0] 总是“赢”过标准库？
Python 启动时自动把“启动上下文目录”插入 sys.path[0]，这个位置具有最高优先级：
-
python script.py→sys.path[0]是script.py所在的绝对路径 -
python -m package.main→sys.path[0]是空字符串''，代表你执行命令时的当前工作目录（pwd输出的路径） - 标准库路径（如
/usr/lib/python3.11/）通常在sys.path中靠后位置，只有前面所有路径都找不到模块时才会轮到它
所以只要你当前目录下有 json.py、os.py 或 requests.py，import json 就一定加载本地文件——解释器根本不会继续往后查。
常见错误现象与识别方法
这类冲突往往不报错，但行为异常，容易误判为逻辑 bug：
-
ImportError: cannot import name 'loads' from 'json'—— 本地json.py是空文件或没定义loads -
AttributeError: module 'os' has no attribute 'path'—— 本地os.py覆盖了标准库，但没实现完整接口 - 第三方库内部调用
import urllib.parse失败 —— 你项目里恰好有个urllib.py，导致其子模块无法解析
快速确认是否中招：在 Python 交互式环境中运行
import json print(json.__file__)
如果输出的是你项目里的路径（比如 /your/project/json.py），那就坐实了本地劫持。
如何避免和修复这类命名冲突？
核心原则：不造轮子，不抢名字。标准库和主流第三方包的名字（json、http、requests、numpy、torch 等）一律回避：
- 本地工具模块改用带前缀或后缀的名称，例如
my_json_utils.py、data_loader.py，而不是json.py - 检查项目根目录及所有子目录，用
find . -name "*.py" | grep -i "json\|os\|sys\|http"快速扫描高危文件名 - CI 流程中加入静态检查：用
grep -r "import json" --include="*.py" . | grep -v "site-packages"辅助定位可疑导入 - 开发时启用
PYTHONVERBOSE=1 python -c "import json"查看实际加载路径（verbose 模式会打印每个搜索步骤）
真正麻烦的不是发现冲突，而是它常在部署后才暴露——本地开发用的 Python 环境可能恰好没装某个标准库模块，掩盖了本地文件的存在；而生产环境装了，反而因覆盖出问题。命名这件事，看似微小，实则是 import 机制里最不容妥协的边界。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
