当 Python 脚本位于子目录（如 kalman/）中且依赖同包内其他模块时，直接执行会因模块搜索路径未包含当前包根目录而报 ModuleNotFoundError；根本解法是确保包结构合规、使用正确的导入方式，并通过 -m 机制或路径管理启动脚本。
当 python 脚本位于子目录（如 `kalman/`）中且依赖同包内其他模块时，直接执行会因模块搜索路径未包含当前包根目录而报 `modulenotfounderror`；根本解法是确保包结构合规、使用正确的导入方式，并通过 `-m` 机制或路径管理启动脚本。
在你的项目结构中：
.
└── kalman/
├── find_observibility.py
├── __init__.py
├── kalman.py
└── model.py
虽然 kalman/ 包含 __init__.py，但直接运行 ./kalman/find_observibility.py 并不等价于以包上下文导入——Python 解释器此时将 kalman/ 视为普通目录，而非可导入的包。因此，from kalman import ... 和 from kalman.model import ... 均会失败，因为顶层 kalman 模块未被识别为已安装或可发现的包。
✅ 正确做法：使用 -m 参数以模块模式运行
确保项目根目录（即 kalman/ 的父目录）在 Python 路径中，然后用以下命令运行：
# 在项目根目录下执行（推荐） python -m kalman.find_observibility
⚠️ 注意：
-
find_observibility.py必须去掉 shebang 行（#!/usr/bin/env python3）或确保其不干扰-m模式； - 文件名应符合 Python 标识符规范（建议重命名为
find_observability.py，避免下划线拼写不一致）； -
__name__ == '__main__'判断仍有效，可正常触发主逻辑。
? 修复 kalman.py 中的相对导入错误
你提到 kalman.py 第 6 行报错：
# ❌ 错误：尝试从顶层 'kalman' 包导入子模块，但当前执行环境无此包上下文 from kalman.model import modelOutput, stateTransition
应改为显式相对导入（因 kalman.py 与 model.py 同属 kalman 包）：
使用 font_manager.addfont() 添加中文字体文件，设置 rcParams['font.family']，并禁用 unicode_minus，使 matplotlib 显示中文。
# ✅ 正确：在 kalman/kalman.py 中使用相对导入 from .model import modelOutput, stateTransition
同理，检查 kalman/__init__.py 中的导入是否均为相对导入（你已正确使用 from .model import ...，这是良好的实践）。
?️ 备选方案：临时修改 sys.path（仅用于调试）
若必须直接执行脚本（如双击或 CI 环境限制），可在 find_observibility.py 开头动态添加父目录到模块搜索路径：
#!/usr/bin/env python3
import sys
from pathlib import Path
# 将项目根目录（kalman 的父目录）加入 sys.path
sys.path.insert(0, str(Path(__file__).parent.parent))
from kalman import outputJacobian, stateJacobian, stateTransition
from make_flight import Rising, Rounds
if __name__ == '__main__':
print('oh my')
⚠️ 注意：该方法破坏了 Python 的模块隔离原则，不推荐用于生产或大型项目；仅作快速验证之用。
✅ 最佳实践总结
| 场景 | 推荐方式 | 说明 |
|---|---|---|
| 日常开发/测试 | python -m kalman.find_observability |
符合 PEP 338，保证包上下文完整 |
| 脚本需独立部署 | 将项目安装为可编辑包：pip install -e .（需配置 setup.py 或 pyproject.toml） |
支持任意位置导入，适合多项目复用 |
| 快速调试 |
sys.path 动态注入（见上） |
简单直接，但需谨慎维护路径逻辑 |
最后，请确认：
- 所有
.py文件命名不含非法字符（如连字符-），建议统一用下划线； -
__init__.py非空（哪怕只含pass），确保 Python 3.3+ 仍将其识别为包； - 运行前终端工作目录为项目根目录（即
kalman/的上级）。
遵循以上方法，即可彻底解决“子目录中无法导入同包模块”的经典路径问题。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
