根本原因是IDE自动将项目根目录加入sys.path，而命令行仅按默认顺序搜索（脚本所在目录→PYTHONPATH→标准库→site-packages），导致模块路径不可见。
为什么IDE里能import，命令行却报ModuleNotFoundError
根本原因不是代码问题，而是Python解释器启动时看到的sys.path不一样。IDE（如PyCharm、VS Code）通常会自动把项目根目录加进sys.path，或者读取你配置的“Python Interpreter”路径并注入额外搜索路径；而命令行直接调用python时，只按默认顺序查：当前脚本所在目录 → PYTHONPATH → 标准库 → site-packages。一旦你的模块不在这些位置里，就必然失败。
- VS Code 的 Python 扩展默认使用“工作区根目录”作为源码根，相当于隐式加了
sys.path.append(./) - PyCharm 在 Run Configuration 里默认勾选 “Add content roots to PYTHONPATH”，这等价于设置了
PYTHONPATH - 命令行执行
python main.py时，sys.path[0]是main.py所在目录，不是你期望的包顶层目录
怎么快速验证是不是PYTHONPATH没生效
别猜，直接在命令行里运行这行命令，看输出里有没有你项目的路径：
python -c "import sys; print('\n'.join(sys.path))"
重点检查第二项（索引为1）是否是你期望的源码根目录。如果没出现，说明PYTHONPATH没被读取，或设置方式不对。
- Windows CMD 中用
set PYTHONPATH查看，PowerShell 里得用$env:PYTHONPATH - Linux/macOS 用
echo $PYTHONPATH，注意大小写——pythonpath或PythonPath全无效 - 如果输出为空，说明环境变量根本没设；如果路径存在但拼错（比如多了一个
\或少了一个/），也会导致查找失败
常见配置错误：PATH和PYTHONPATH混为一谈
PATH管的是python.exe在哪，PYTHONPATH管的是import xxx时去哪找xxx.py。两者完全独立，改错一个毫无作用。
立即学习“Python免费学习笔记（深入）”；
- 误把
C:\myproject\src加进PATH：系统不会因此找到mylib.utils，只会让你能在任意目录敲src（然后报错） - 误以为装了虚拟环境就自动解决导入：venv 只隔离包依赖，不改变模块搜索逻辑；
sys.path依然从空字符串（当前目录）开始搜 - 在脚本开头写
sys.path.append('..')：临时有效，但一旦用python -m mypackage.module方式运行，__file__位置变化，相对路径就失效
最稳的临时调试方案：用-c参数注入路径
不想改环境变量又想快速验证？用python -c绕过启动逻辑，手动构造sys.path再执行：
python -c "import sys; sys.path.insert(0, './src'); import mypackage; print(mypackage.__file__)”
这条命令把./src插到搜索路径最前面，然后尝试导入。成功了，说明路径对、包结构也对；失败了，就该去看__init__.py是否存在或模块名拼写是否正确。
- 路径必须是**绝对路径或相对于当前命令行工作目录的相对路径**；
./src在CMD里要确保你cd进了项目根目录 - 不要用
os.path.abspath之类——-c里没法跨行写复杂逻辑，保持单行简洁 - 这个方法适合CI脚本或临时排查，长期项目仍建议用
PYTHONPATH或安装为可编辑包（pip install -e .）
PYTHONPATH配置正确，如果项目里有同名模块（比如你写了json.py），它会覆盖标准库json，导致后续导入崩掉——这种错误不会提示路径问题，而是抛出奇怪的AttributeError或ImportError，得顺着import链逐个print(__file__)才能揪出来。 
