Laravel目录结构有明确职责，不可随意改动：public必须为Web根目录以防敏感文件泄露；storage和bootstrap/cache需正确设置属主权限；配置覆盖仅限顶层键；自定义目录需符合PSR-4自动加载规则。
直接说结论：Laravel 的目录结构不是“必须死守”的教条，但每个默认目录的存在都有明确职责；跳过理解就乱动，php artisan serve 能跑不代表 php artisan config:cache 不报错，更不代表上线后 storage/logs/laravel.log 里不会堆满权限错误或缓存失效日志。
public 目录为什么必须是 Web 服务器唯一可访问的根目录
所有 HTTP 请求都必须经过 public/index.php 入口，它初始化应用、加载配置、分发路由。如果你把 Web 服务器 DocumentRoot 指向项目根目录，.env、config/database.php、storage/app 这些敏感路径可能被直接下载——这不是理论风险，Nginx/Apache 配置漏掉 location ~ .php$ 或 Apache 没启用 mod_rewrite 时真实发生过。
- Apache 必须启用
AllowOverride All并确保.htaccess生效，否则public/.htaccess里的重写规则不触发，/login会 404 - Nginx 需显式配置
try_files $uri $uri/ /index.php?$query_string;，漏掉$query_string会导致 POST 数据丢失 - 上传文件若用
Storage::disk('public')，实际路径是public/storage，需运行php artisan storage:link创建符号链接，否则前端无法通过 URL 访问
storage 和 bootstrap/cache 目录的写入权限到底要开给谁
Laravel 在运行时会往这两个目录写日志、缓存、session、视图编译文件。权限不对，轻则 log write failed，重则 Class 'AppProvidersAppServiceProvider' not found（因为服务提供者缓存写失败，bootstrap/cache/packages.php 损坏）。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- Linux 下推荐用
chown -R www-data:www-data storage bootstrap/cache（根据你的 Web 用户组调整，如nginx或apache） - 绝对不要用
chmod 777，这等于把钥匙交给所有人；chmod -R 755 storage也不行——storage/logs需要写入，但storage/app下某些子目录只需读 - 部署脚本中务必包含
php artisan config:clear && php artisan cache:clear && php artisan view:clear，否则旧缓存残留会掩盖新代码问题
config 目录里的文件怎么被 .env 覆盖又不互相干扰
config/ 下每个 PHP 文件返回一个数组，.env 中的键值对通过 Dotenv 库加载进环境变量，再由框架在 bootstrap/app.php 初始化阶段注入对应配置项。关键点在于覆盖逻辑只发生在顶层键，且仅限字符串/布尔/数字类型。
-
.env里写APP_NAME=MyApp→ 覆盖config/app.php中的'name' => env('APP_NAME', 'Laravel') - 但
config/database.php中的'connections.mysql.host'是嵌套结构，.env无法直接覆盖这个路径，只能靠env('DB_HOST', '127.0.0.1')这种逐层取值方式间接影响 - 自定义配置文件如
config/custom.php必须手动在config/app.php的'providers'数组里注册服务提供者，否则config('custom.key')永远返回null
app 目录下子目录不是摆设，但别硬套命名空间
app/Http/Controllers 和 app/Models 是约定，不是强制。你完全可以把控制器放在 app/Actions，只要 Composer 自动加载规则（composer.json 的 "autoload": {"psr-4": {"App\": "app/"}}）能解析到类，Laravel 就认。
- 但
php artisan make:model User默认生成到app/Models，改路径就得同步改命令参数，比如php artisan make:model Domain/User，否则 IDE 可能无法跳转 -
app/Providers里的类会被config/app.php中的'providers'列表自动注册，删了某项，Auth::user()可能突然 null —— 因为AuthServiceProvider没加载 -
app/Console/Commands下的命令类，只有被app/Providers/AppServiceProvider.php的commands()方法注册，或在config/app.php的'commands'数组里声明，才能被php artisan list看到
最常被忽略的是 bootstrap/cache 目录的双面性：它加速启动，但也容易成为“黑盒”。本地开发时关掉配置缓存（APP_DEBUG=true 且不运行 config:cache），上线前再开启——中间任何一次忘记清缓存，都可能导致新配置不生效，而错误日志里只显示“class not found”这种误导信息。
