Python导入核心是提前将模块所在路径加入sys.path，而非报错后补救；关键是在解析import前确保目标模块路径已存在sys.path中，且包结构合规（含__init__.py）。
核心在于让 Python 在解析 import 语句时，就能从 sys.path 中准确定位到目标模块——不是等报错后再补救，而是提前把路径“摆对位置”。关键不在于写多复杂的导入语法，而在于控制解释器启动时的搜索上下文。
确认当前工作目录与脚本位置是否一致
Python 默认把执行命令时的当前工作目录（即 os.getcwd()）和脚本所在目录（__file__ 的父目录）都加入 sys.path，但二者常不一致。比如你在项目根目录外执行 python src/main.py，此时 sys.path[0] 是你所在的“外部目录”，而非 src 所在的根目录。
- 运行前先检查：
python -c "import sys; print('CWD:', sys.path[0]); print('__file__ dir:', sys.path[1] if len(sys.path) > 1 else 'N/A')" - 统一用脚本所在目录为基准：在主入口文件开头加
import sys, os; sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))，确保它优先于其他路径
用 -m 方式运行，激活包上下文
直接运行 python main.py 是以文件为单位启动，不触发包机制；而 python -m mypackage.main 会把当前目录当作包根，并自动识别含 __init__.py 的子目录为合法包。
- 前提：项目根目录下有
__init__.py（可为空），且子目录结构符合包规范（如utils/__init__.py） - 操作示例：在项目根目录下执行
python -m app.main，此时from utils.helpers import foo就能自然解析 - 避免在子目录里执行
-m，否则包路径会错层
避免在解析阶段依赖动态路径修补
在代码里写 sys.path.append(...) 属于运行时干预，它发生在 import 已开始解析之后。一旦模块 A 在顶层就导入了模块 B，而 B 又依赖尚未 append 的路径，就会在解析阶段直接失败。
- 不要在被 import 的模块中修改
sys.path（如utils.py里加append），这会让调用方不可控 - 若必须跨远路径，改用环境变量
PYTHONPATH预置：启动前执行export PYTHONPATH="/path/to/root:$PYTHONPATH"，让解释器在解析第一行 import 前就加载完整路径 - 生产环境推荐打包安装：
pip install -e .（需有setup.py或pyproject.toml），使模块名直接注册进 site-packages
验证导入路径是否生效在解析前
真正的“解析阶段规避”，是确保 import xxx 这行代码被执行前，xxx 已经出现在 sys.path 的某个目录下，并且该目录中存在对应文件或包结构。
- 快速验证：在报错前插入
import sys; assert 'your_module_name' in [os.path.basename(p) for p in sys.path if os.path.isdir(p)], "Module root not in path" - 检查包结构有效性：目标目录下必须有
__init__.py（哪怕空文件），否则 Python 不认为它是可导入的包 - 区分模块名与文件名：导入语句中的名字是模块名，不是文件路径；
from config import DB_URL要求存在config.py或config/__init__.py，而不是config.py被硬编码在路径里
