diff --git a/memory/2026-02-03.md b/memory/2026-02-03.md index bff2e57..8120ec8 100644 --- a/memory/2026-02-03.md +++ b/memory/2026-02-03.md @@ -1,22 +1,70 @@ -# 2026-02-03 - 每日记忆 +# 2026-02-03 - 关键错误教训 -## 关键错误反思 +## 🚨 反复犯的低级错误 ### 错误 1: 目录大小写混淆 - **问题**: 项目使用 `app/Filament/` (大写 F),我一直修改 `app/filament/` (小写 f) - **影响**: 所有修改都写在错误的目录下,完全无效 -- **教训**: 必须先检查项目结构,确认正确的路径再修改 +- **根本原因**: 没有先检查 `ls -la app/` 确认实际目录结构 +- **教训**: 永远先用 `ls` 查看目录结构,**确认正确路径再修改**! ### 错误 2: 错误的 import 语句 - **问题**: 一直添加 `use BackedEnum;` 和 `use UnitEnum;` -- **事实**: 这些是 PHP 8.2 内置的枚举类型,不是类,不需要 import +- **事实**: 这些是 PHP 8.2 内置的枚举类型,不是类,**完全不需要 import** - **影响**: 导致类加载失败,类型检查一直报错 -- **教训**: 查看现有代码学习,参考可以正常工作的文件 (SupplierResource.php) +- **根本原因**: 没有仔细阅读现有代码 (SupplierResource.php 可以正常工作,没有这些 import) +- **教训**: **UnitEnum 和 BackedEnum 是 PHP 内置枚举类型,永远不要 import!** ### 错误 3: 重复犯同样错误 - **问题**: 用户多次指出问题,我没有真正理解就继续修改 - **影响**: 浪费大量时间,重复犯同样错误 -- **教训**: 停下来彻底诊断,理解根本原因,然后一次性正确修复 +- **根本原因**: 没有停下来彻底诊断,理解根本原因 +- **教训**: **当问题重复出现时,立即停下来,彻底诊断,理解根本原因,然后一次性正确修复!** + +--- + +## ✅ 正确的做法 + +### 1. 确认目录结构 +```bash +# 永远先用这个确认路径 +ls -la app/Filament/Resources/ +``` + +### 2. 类型声明 (正确) +```php +// 正确 - PHP 8.2 内置枚举,不需要 import +protected static string|BackedEnum|null $navigationIcon = '...'; +protected static UnitEnum|string|null $navigationGroup = '...'; +``` + +### 3. 查看现有代码学习 +```bash +# 参考可以正常工作的文件 +cat app/Filament/Resources/Suppliers/SupplierResource.php | grep "use.*Enum" +# 结果:空,因为不需要 import +``` + +--- + +## 📋 检查清单 + +在修改任何 Filament Resource 文件之前,**必须**检查: + +- [ ] 确认正确的目录路径 (`app/Filament/` 不是 `app/filament/`) +- [ ] 参考现有正常工作的代码 +- [ ] 确认不需要 `use UnitEnum` 或 `use BackedEnum` +- [ ] 使用 `php -l` 检查语法 +- [ ] 验证类型声明符合 Filament 4.x 规范 + +--- + +## 🔥 切记 + +1. **永远** 先用 `ls` 查看目录结构 +2. **永远** 不要 `use UnitEnum` 或 `use BackedEnum` +3. **永远** 当问题重复时,停下来彻底诊断 +4. **永远** 从现有正常工作的代码学习 ---