1.3 KiB
1.3 KiB
title, type, tags, last_updated
| title | type | tags | last_updated |
|---|---|---|---|
| MentalModel | concept | 2026-05-02 |
Definition
Mental Model（心智模型）是开发者对代码库结构、工作原理和边界的内在理解。准确的代码库心智模型能够支持开发者快速定位问题、预测变更影响、进行有效的代码审查。
Building a Codebase Mental Model
Three-Tier Explanation Structure
- One-line statement — 一句话描述代码库是什么
- Five-minute overview — 五分钟高层解释：任务、输入、输出、关键文件、主代码路径
- Deep dive — 深度分析：类型、运行时、入口点、结构表、关键边界、详细代码流
Key Components
- Top-level structure: 目录结构和职责划分
- Entry points: 启动文件、路由、配置
- Data flow: 输入如何流转、处理、输出
- Key boundaries: 展示层 / 应用层 / 持久层的边界
- Ownership map: 每个文件/模块负责什么
Metrics for Good Mental Model
- 新开发者 5 分钟内能识别主入口点
- 能正确预测代码变更的影响范围
- 能准确描述跨模块的数据流
Related Concepts
- CodebaseOnboarding — 代码库 onboarding 方法论
- ExecutionTracing — 执行路径追踪
- EvidenceFirstReasoning — 证据优先推理