ThinkPHP中__PUBLIC__不生效的根本原因是其为编译期静态替换，无法动态适配Nginx重写、子目录部署或URL模式切换；应改用Url::build()或动态计算__ROOT__配合静态资源路径，并确保Nginx alias配置正确。
ThinkPHP 里 __PUBLIC__ 不生效，页面加载不到 CSS/JS 怎么办
根本原因不是路径写错了，而是 ThinkPHP 的 __PUBLIC__ 是编译期静态替换，一旦你用了 Nginx 重写、子目录部署、或启用了 URL 模式切换（比如开启 url_html_suffix），它就无法动态适配当前请求上下文。尤其在二级目录部署（如 http://example.com/myapp/）时，__PUBLIC__ 默认仍指向根目录 /public/，导致资源 404。
- 检查是否启用了
APP_SUB_DOMAIN_DEPLOY或自定义了URL_DOMAIN_ROOT，这两项会干扰基础路径推导 - 确认
APP_PATH和ROOT_PATH定义正确，ThinkPHP 依赖它们反推PUBLIC_PATH - 不要在模板里硬写
/public/css/app.css—— 这样彻底绕过框架路径逻辑，失去部署灵活性
用 think\facade\Url::build() 生成资源路径反而更稳
Url::build() 本身是为路由服务的，但它支持空控制器/空操作调用，能自动带出当前应用的基础 URL 前缀（包括子目录、域名、协议）。配合 __ROOT__ 或直接拼接，比依赖 __PUBLIC__ 更可控。
- 在模板中写：
<link rel="stylesheet" href="<?= Url::build('', '', false, true) ?>/static/css/app.css">—— 第四个参数true表示返回完整 URL（含域名和子目录） - 如果项目始终部署在根目录，且禁用域名绑定，可简化为
<?= __ROOT__ ?>/static/css/app.css，但注意__ROOT__由Request::root()推导，受REQUEST_URI和SCRIPT_NAME影响，Nginx 配置里别漏掉fastcgi_script_name - 避免混用：不要一半用
__PUBLIC__，一半用Url::build()，路径逻辑不统一容易在调试环境和生产环境表现不一致
Nginx 子目录部署时，alias 和 root 配置错一个字符，静态资源全挂
ThinkPHP 在子目录运行（如 /myapp/）时，Nginx 必须把 /myapp/static/ 映射到物理 /path/to/public/static/，而不是靠 PHP 转发。这时候用 alias 是唯一可靠方式；用 root 会导致路径多拼一层，比如请求 /myapp/static/css/a.css，root /var/www 会去找 /var/www/myapp/static/css/a.css，而实际文件在 /var/www/public/static/css/a.css。
- 正确写法：
location ^~ /myapp/static/ { alias /var/www/public/static/; }—— 注意结尾斜杠和alias路径结尾斜杠必须匹配 - 千万别写成
location /myapp/static/ { root /var/www/public; }，这会让 Nginx 尝试访问/var/www/public/myapp/static/ - 如果用的是 ThinkPHP 6.1+，且开启了
app.app_host配置，还要确保 Nginx 的Host头没被代理层篡改，否则Request::domain()返回异常，连带影响__ROOT__
模板里手动拼 __STATIC__ 常量？小心缓存和 CLI 场景失效
有人图省事在 common.php 里定义 define('__STATIC__', __ROOT__ . '/static')，看似方便，但在命令行执行（如 php think queue:work）时，__ROOT__ 可能为空或返回 /，导致生成错误路径；另外模板引擎缓存开启后，常量值可能被固化，换域名或子目录后不刷新。
立即学习“PHP免费学习笔记（深入）”；
- 推荐做法：在基础模板（如
layout.html）顶部用 PHP 块动态计算：<? $static = \think\facade\Request::instance()->root() . '/static'; ?>，再用<?= $static ?>插入路径 - 如果用的是 ThinkPHP 6.2+，可考虑在
view_replace_str配置里注册一个运行时替换规则，把{:STATIC}替换成动态路径，比常量更安全 - 所有路径输出前加个
htmlspecialchars()，防止 XSS —— 特别是当路径来自用户输入或配置项时
最麻烦的不是写不对，而是路径在本地开发时一切正常，一上测试环境就断链，而且断得毫无规律。问题往往藏在 Nginx 的 fastcgi_param SCRIPT_NAME 是否传递、PHP 的 $_SERVER['PHP_SELF'] 是否被污染、或者 CDN 回源时 Header 被精简这几个地方。查的时候别只盯 PHP 代码。
