thinkphp 6/8 多应用模块目录名必须全小写，如admin、api；控制器文件名与类名须严格一致且命名空间匹配，否则报class not found或404；public为唯一web入口，runtime需可写，config仅加载根目录php文件。
ThinkPHP 6/8 多应用目录结构必须严格按小写命名
模块目录名大小写错误是新手最常踩的坑，直接导致 Class not found 或 404。ThinkPHP 6+ 默认启用多应用模式，app/ 下每个子目录就是一个应用（如 admin、api、index），这些目录名必须全小写，不能是 Admin 或 API。
控制器类文件也必须严格匹配：比如 app/admin/controller/User.php 中必须定义 class User，且命名空间为 app\admin\controller；若写成 App\Admin\Controller\User 或漏掉 \admin\ 段，路由解析就会失败。
-
config/app.php中的'default_module' => 'index'必须与实际存在的模块目录名完全一致（全小写） - 模块内控制器方法默认访问规则是
/模块名/控制器名/方法名，例如/admin/user/index - 若用命令行生成控制器，务必指定模块：
php think make:controller admin/User，不加admin/前缀会默认建在index模块下
public/ 是唯一 Web 入口，静态资源放错位置必 404
public/ 目录外的所有内容（包括 app/、config/、runtime/）都不应被 Web 服务器直接访问。所有请求必须经由 public/index.php 进入框架生命周期。这意味着：
- CSS/JS/图片等静态资源只能放在
public/static/（或public/uploads/等子目录），放app/static/或public/css/（无static包裹）会导致浏览器返回 404 -
.htaccess（Apache）或nginx.conf重写规则必须指向public/index.php，否则 URL 路由失效 - 部署到虚拟主机时，需将域名根目录绑定到
public/，而不是项目根目录
runtime/ 不可写 = 白屏无报错（尤其生产环境）
runtime/ 是 ThinkPHP 缓存日志模板编译文件的落盘目录，Web 服务器进程（如 www-data、nginx、apache）必须对其有读写权限。否则首次访问会白屏，且当 APP_DEBUG = false 时，连错误日志都写不进去，排查极其困难。
- Linux 下常用修复方式：
chmod -R 755 runtime/或chown -R www-data:www-data runtime/ - Windows IIS 下需确认应用池用户对
runtime/有修改权限 - CI/CD 部署脚本中必须包含
mkdir -p runtime/{log,cache,view,route}并赋权，不能只靠首次访问自动创建
config/ 只加载一级 PHP 文件，子目录配置不会自动合并
ThinkPHP 的配置加载机制很“直给”：它只会扫描 config/ 目录下的 *.php 文件（如 database.php、app.php），而忽略任何子目录（如 config/database/mysql.php）。想组织复杂配置，不能靠目录嵌套，得靠手动引入或环境变量。
- 正确做法：在
config/database.php中用return array_merge(require 'mysql.php', require 'redis.php');显式合并 - 更推荐方式：用
env文件 +think\facade\Config::set()动态注入，避免硬编码敏感信息 - 注意
config/下的extra/目录是特例，框架会自动加载其中的 PHP 文件，但前提是该目录存在且文件名不带扩展冲突（如不能叫extra.php）
runtime/ 权限和 config/ 的加载边界——前者让问题静默失败，后者让配置看似合理却根本没生效。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
