根本原因是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没被读取，或设置方式不对。

huaweicloud-python-sdk-helper

华为云 Python SDK 查询工具。自动发现已安装 SDK 的服务包、Client类、API 方法、入参详情、类信息（__init__ 参数、属性、类型、描述），支持关键字搜索，快速定位目标 API 使用方法。

下载

• Windows CMD 中用set PYTHONPATH查看，PowerShell 里得用$env:PYTHONPATH
• Linux/macOS 用echo $PYTHONPATH，注意大小写——pythonpath或PythonPath全无效
• 如果输出为空，说明环境变量根本没设；如果路径存在但拼错（比如多了一个\或少了一个/），也会导致查找失败

常见配置错误：PATH和PYTHONPATH混为一谈

PATH管的是python.exe在哪，PYTHONPATH管的是import xxx时去哪找xxx.py。两者完全独立，改错一个毫无作用。

• 误把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__)才能揪出来。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！