ThinkPHP 6.x 默认不自动加载 .env 文件，需在 public/index.php 中手动调用 Dotenv::createImmutable()->load()；APP_ENV 切换需配合 think\Env::set()；多应用路由须显式导入并绑定域名。
为什么 XAMPP 下 .env 文件不生效
ThinkPHP 6.x 默认不会自动加载 .env，哪怕你把它放在项目根目录（和 app/、config/ 同级），XAMPP 的 PHP 进程也完全感知不到。这不是 XAMPP 的锅，是 TP6 的设计逻辑：它把环境变量加载交给开发者显式控制。
必须在 public/index.php 中手动引入并执行 vlucas/phpdotenv：
use Dotenv\Dotenv; // 在 require __DIR__.'/../vendor/autoload.php'; 之后、require __DIR__.'/../start.php'; 之前插入 $dotenv = Dotenv::createImmutable(__DIR__.'/..'); $dotenv->load();
常见错误：
-
.env文件保存为 UTF-8 with BOM —— 会导致Dotenv解析失败，静默跳过，毫无报错 - 等号两边写了空格，比如
APP_ENV = dev→ 必须写成APP_ENV=dev - 敏感值含特殊字符但没加单引号，如
DB_PASSWORD=p@ss#123→ 应写为DB_PASSWORD='p@ss#123'
XAMPP 中 APP_ENV 切换多环境配置为何无效
设了 APP_ENV=prod 在 .env 里，不代表框架就会加载 config/prod/ 下的配置。TP6 的环境切换依赖两件事：一是 APP_ENV 的值被读取，二是这个值被传给框架内部环境管理器。
立即学习“PHP免费学习笔记（深入）”；
在 public/index.php 中，$dotenv->load() 之后，必须紧接着调用：
think\Env::set('APP_ENV', 'prod');
注意三点：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 值必须小写，且严格匹配
config/下子目录名（prod✅，PROD❌，production❌） - CLI 模式（如
php think migrate）也要在think入口脚本里做同样设置，不能只靠.env - XAMPP 的 Apache 若已通过
fastcgi_param APP_ENV prod;透传，框架会优先取服务器变量，跳过.env中的值
多应用模式下路由 404 的真实原因
在 XAMPP 上跑 TP6 多应用，最常卡在「访问 /admin/index/index 报 404」——不是伪静态没配好，而是路由根本没被加载。
TP6 不会扫描 app/admin/route.php，哪怕它存在且语法正确。你必须在全局路由入口 route/route.php 中显式导入：
use think\facade\Route;
Route::import('admin', 'admin'); // 第二个参数是子应用目录名，大小写敏感
关键细节：
-
app/目录必须为空（删掉原始的controller/、model/等）；否则框架检测到app/controller就认定是单应用，think-multi-app中间件直接失效 -
Route::import('admin')写法错误——缺第二个参数会导致路径解析错乱，加载的是app/admin/route.php还是app/route.php？不确定 - 每个新增子应用（如
api）都得追加一行Route::import('api', 'api');，漏掉就等于该应用路由不存在
域名绑定在 XAMPP 下必须手写入口文件
config/app.php 里的 'domain_bind' => ['admin.local' => 'admin'] 在 XAMPP 环境中完全不生效。TP6 多应用的域名路由绑定，只认 public/index.php 中的 \think\App::bind()。
例如，你在 C:\xampp\apache\conf\extra\httpd-vhosts.conf 配了两个虚拟主机指向同一项目，就要在入口文件里判断 Host：
if ($_SERVER['HTTP_HOST'] === 'admin.local') {
\think\App::bind('admin');
}
// 必须放在 \think\App::run() 之前，且不能晚于 autoload.php 加载之后
容易忽略的点：
- 绑定发生在请求生命周期早期，一旦绑错（比如绑成
'Admin'而不是'admin'），后续所有逻辑（路由、配置、中间件）都会走错应用 - 子应用目录名只能是小写字母+下划线（
app/admin✅，app/Admin❌，app/admin-v2❌） - 绑定后，URL 中的应用前缀（如
/admin/xxx）会被自动剥离，实际匹配的是app/admin/route.php里定义的路径部分
