laravel 10强制使用完整类名路由，须显式导入控制器并采用[class::class, 'method']语法，摒弃隐式命名空间；核心是解耦胖控制器，将验证、通知等职责抽离为可测试的服务类，使控制器退化为胶水层。
控制器文件太多，先别急着拆目录
直接按功能建子目录（比如 App\Http\Controllers\Admin）不是错，但容易陷入“目录分得清，逻辑依然糊”的陷阱。真正卡住维护节奏的，往往不是文件数量，而是单个控制器里混着验证、创建、上传、通知、事件触发等七八种职责。你删一个方法前得翻三页代码确认它没被其他地方悄悄调用——这种恐惧感比文件多更致命。
优先把“胖控制器”切成可注入的服务类
看到 store() 方法里有七步操作？别先动路由或目录结构。先把每块逻辑拎出来封装成服务：
-
UserRegistrationService负责用户创建、密码哈希、头像存储 -
VoucherGenerationService专注生成并绑定优惠券 -
WelcomeNotificationService只管发欢迎邮件和管理员通知
控制器退化为胶水层：接收请求 → 调用服务 → 返回响应。好处是测试时不用启动整个 HTTP 栈，直接 new 一个服务类就能测核心逻辑；改某个通知渠道，只动对应服务，不影响注册主流程。
Laravel 10 路由必须用完整类名，别再依赖隐式命名空间
如果你还在用 Route::get('/', 'HomeController@index') 这种写法，升级到 Laravel 10 后会报错。必须显式导入并使用数组语法：use App\Http\Controllers\HomeController; Route::get('/', [HomeController::class, 'index']);
Laravel 13.2.0 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
这看似多写两行，实则强制你直面控制器位置。重构时更容易判断：这个 DashboardController 真该在 Admin 下，还是该拆成 Admin\ReportController 和 Admin\UserManagementController？路径不再自动补全，你就不得不思考组织逻辑。
模块化不是银弹，先从“命名空间分组”开始试水
别一上来就装 nwidart/laravel-modules。先用原生路由分组验证模块边界是否合理：
Route::prefix('api/v1')->namespace('Api\V1')->group(...)Route::prefix('admin')->namespace('Admin')->group(...)
每个分组下只放真正属于该域的控制器。如果某天发现 Admin 组里混进了大量和后台无关的订单处理逻辑，说明边界错了——这时再考虑抽成独立模块才靠谱。过早模块化只会让 composer dump-autoload 变慢，IDE 跳转变卡，新人更难定位代码。
最常被忽略的一点：控制器方法命名本身就在泄露架构问题。如果方法名叫 handleOrderAndNotifyAndLogAndSyncToCrm()，那目录结构再漂亮也救不了——先砍方法，再理路径。
