laravel学习笔记应按五大核心知识域归类：「路由与控制器」对应routes/、「模型与数据库」对应models/、「视图与模板」对应views/、「请求与验证」对应requests/、「工具与调试」对应tools/；每条笔记须标注✘错误、⚠注意、✅方案或?原理前缀，且末尾附真实可跳转路径（如→ app/http/controllers/homecontroller.php），无路径者删除；旧笔记通过find自动清理或git分支归档，禁用带序号的临时标题。
你需要把零散的Laravel学习笔记按功能模块、问题类型和代码层级归类，避免翻找时在“无线分类”“验证规则”“集合分组”之间反复跳转，找不到某段关键逻辑的出处。
按知识域划分核心笔记
把笔记拆成「路由与控制器」「模型与数据库」「视图与模板」「请求与验证」「工具与调试」五大块，每块对应 Laravel 的核心架构层。例如“无线分类”属于「模型与数据库」下的数据结构设计，“自定义验证规则”必须放在「请求与验证」里，不能混进控制器笔记中。
新建一个 notes/laravel/ 目录，在其下创建五个子目录：【routes】、【models】、【views】、【requests】、【tools】。所有原始笔记文件按内容归属移动进去，不保留原文件名中的日期或序号——它们会干扰检索。
这一步做完后，你再查“静态方法里怎么调用非静态方法”，直接进 models/ 就能找到对应片段，不用全文搜索。
按问题类型标记笔记条目
在每个子目录内，对每条笔记开头加统一前缀：
✘ 错误：用于记录报错信息及解决过程，如“✘ Undefined variable: cates”；
⚠ 注意：用于强调易踩坑点，如“⚠ 静态方法中不能使用 $this”；
✅ 方案：用于记录已验证可行的实现方式，如“✅ 使用 sometimes 实现条件验证”；
? 原理：用于解释底层机制，如“? groupBy() 是 Collection 方法，不是 Query Builder 方法”。
不要在同一个文件里混用多种前缀——每条笔记只属于一种类型。一条笔记若同时含错误现象和解决方案，拆成两条：一条标 ✘，一条标 ✅。
按代码位置锚定引用路径
每条笔记末尾必须注明该知识点实际生效的代码路径，格式为：→ app/Http/Controllers/Admin/CategoryController.php → app/Category.php → resources/views/admin/category/edit.blade.php。
路径必须真实存在且可点击跳转（VS Code 中 Ctrl+Click 可打开）。如果笔记涉及 Artisan 命令，写明命令本身及典型输出，如：→ php artisan make:request CheckCategory → 生成 app/Http/Requests/CheckCategory.php。
没有路径标注的笔记一律删除——它意味着你根本没在项目里真正跑通过这段逻辑，只是抄录了别人的话。
按修改频率动态归档旧笔记
方法一：每月初执行一次清理
进入 notes/laravel/ 目录，运行：find . -name "*.md" -mtime +30 -delete。超过30天未修改的 Markdown 笔记自动清除。
方法二：用 Git 分支隔离历史版本
每次重构笔记结构前，先执行：git checkout -b archive/v202607 → 整理完新结构 → git add . && git commit -m "reorg: models + requests" → git checkout main。旧结构永远保留在对应分支，不污染当前工作区。
注意：不要保留“laravel笔记5 无线分类3”这类带序号的原始标题，它们是临时产物，不是知识节点。
