Python导入文件总报错？这3个坑90%的人都踩过

你是不是也遇到过这种抓狂时刻——明明文件就在眼皮底下，Python却死活找不到，报错"ModuleNotFoundError"看得人头大？更离谱的是，同事电脑上跑得好好的代码，到你这就罢工。别慌，这不是你代码写得烂，而是Python的导入机制确实有点"脾气"。 问题的根源在于Python的导入路径机制。它不像你想的那样智能，不会自动扫描整个电脑找文件，而是严格按照`sys.path`这个列表里的目录挨个搜。当前目录、Python安装目录、环境变量PYTHONPATH里的路径，缺一不可。很多新手把py文件随手扔在桌面，运行时就懵圈了——因为桌面根本不在Python的"搜索雷达"里。更坑的是，同名文件还会互相"打架"，比如自己写了个叫`random.py`的文件，直接覆盖掉Python内置的随机数模块，程序莫名其妙崩溃。

除了路径问题，文件结构也是重灾区。很多人习惯把所有代码塞一个文件夹，一旦项目变大，import就开始抽风。正确的姿势是用"包"来组织代码——在文件夹里放一个空的`init.py`文件，Python就把它当成一个模块包，里面的文件就能用`from 文件夹 import 模块`这种方式调用。相对导入和绝对导入的区别也要搞清楚，`.`代表当前目录，`..`是上级目录，写错了就会报"attempted relative import beyond top-level package"。

实战中最稳的做法是：小项目直接用`sys.path.append()`临时加路径，大项目老老实实写`setup.py`或者用`PYTHONPATH`环境变量。IDE里运行正常，命令行却报错？大概率是工作目录设置不同。养成在脚本开头打印`print(os.path.abspath(file))`的习惯，一眼就能定位问题。 说到底，Python导入文件不难，难的是理解它"按图索骥"的底层逻辑。路径对了，结构清了，报错自然就少了。

你导入文件时还踩过哪些奇葩的坑？评论区聊聊，咱们一起排雷！