public/目录是ThinkPHP静态资源唯一合法入口，必须将CSS、JS等放于public/static/，模板中须用url()生成路径并配置CDN与哈希版本控制。
public/ 目录才是静态资源的唯一合法入口
ThinkPHP 的静态资源（CSS、JS、图片等）不能放在 app/ 或 runtime/ 下，必须放在 public/ 目录里，否则 Web 服务器根本无法直接响应请求。框架本身不代理静态文件，Apache/Nginx 是靠把 public/ 设为网站根目录来实现的。
常见错误现象：404 Not Found 加载 /static/css/app.css，但实际路径是 public/static/css/app.css；或者误把资源放进了 app/view/，结果部署后全挂。
-
public/static/是最常用且推荐的存放位置，和 ThinkPHP 官方模板保持一致 - 不要用
public/assets/或public/res/等自定义路径——除非你明确改了 Nginx 的location规则并同步更新所有link和script标签 - 如果用了多模块，仍统一走
public/static/，别按模块拆分目录（比如public/admin-static/），否则 CDN 缓存、版本管理、构建工具都会变复杂
模板里引用静态资源必须用 url() 辅助函数
硬写 <link href="/static/css/app.css"> 看似能跑，但一加子目录或部署到非根路径（比如 https://example.com/myapp/）就炸。ThinkPHP 的 url() 不只用于路由，它也能生成正确的静态资源 URL。
正确做法是统一用 {:url('static/css/app.css')} 或更稳妥的 {:url('/static/css/app.css', '', false)}（第三个参数 false 表示不加 URL 前缀，避免重复拼接）。
立即学习“PHP免费学习笔记（深入）”；
- 如果启用了 URL 路由重写（
url_html_suffix配置），url()可能自动补后缀，对静态资源要禁用：传false作为第三个参数 - 在 JS 文件里动态加载 CSS？别拼字符串，用
__ROOT__/static/...—— 这个常量由框架在模板编译时注入，比手写/更可靠 - Vite 或 Webpack 构建产物放
public/static/dist/？记得在config/app.php中确认app_host和url_domain_root配置没干扰路径生成
资源版本控制别只靠时间戳，优先用文件内容哈希
ThinkPHP 自带的 build_url() 或手动加 ?v=20240520 解决缓存问题，但治标不治本：文件没变也强制刷新，CDN 失效率高，浏览器可能重复下载。
真正有效的做法是构建时生成带哈希的文件名（如 app.a1b2c3d4.css），再通过配置或插件把映射关系写进 JSON，模板里调用时自动替换。
- 原生 ThinkPHP 不内置该能力，需配合构建工具：Vite 输出
manifest.json，然后写个简单函数读取并替换url()结果 - 别把哈希逻辑塞进模板里实时计算 md5——性能差，且无法利用构建时的 Tree-shaking 和压缩优势
- 如果项目没构建流程，至少用
filemtime()动态加时间戳：{:url('static/css/app.css').'?v='.filemtime(public_path().'static/css/app.css')}
CDN 或对象存储托管静态资源时，注意跨域与 HTTPS 混合内容
把 public/static/ 同步到 CDN 后，模板里还得改链接，否则还是走本地。但直接写死 https://cdn.example.com/static/... 会带来两个隐患：开发环境无法调试、HTTP/HTTPS 混合导致浏览器拦截。
安全做法是用配置驱动：在 config/app.php 中加一个 static_host 项，开发设为空，生产设为 CDN 地址，模板里用 {:config('app.static_host') ?: ''}/static/xxx.css。
- 如果 CDN 开启了 Referer 白名单，确保你的域名已加入，否则图片/CSS 会
403 - 启用 HTTPS 后，所有静态资源地址必须是
https://或协议相对路径//cdn.example.com/...，否则现代浏览器直接屏蔽 - 对象存储（如阿里云 OSS、腾讯云 COS）建议绑定自定义域名 + 强制 HTTPS，并关闭“匿名读”，用临时 Token 或签名 URL 控制敏感资源访问
最易被忽略的是：资源路径变更后，浏览器强缓存可能让旧 HTML 一直尝试加载旧路径，哪怕你已经清空了 CDN 缓存。上线前最好在 HTML 中加一行 <meta http-equiv="Cache-Control" content="no-cache"> 临时顶一顶，等新资源稳定后再撤掉。
