ThinkPHP需用asset()函数替代__STATIC__生成带版本号的静态资源路径，配合CDN配置和Web服务器正确设置才能解决缓存与404问题。
怎么让ThinkPHP自动加版本号防缓存
直接改config/app.php里的app_debug和app_status没用，关键在资源路径生成逻辑。ThinkPHP默认不带版本参数，浏览器会缓存css、js，改了文件但用户看不到效果。
实操上，必须启用build_url机制，配合asset函数或__STATIC__常量做改造：
- 在
config/app.php中确保'app_debug' => true（开发时）或手动开启'url_build_cache' => false，否则asset()可能复用旧路径 - 模板里别写死
/static/js/app.js，改用{:asset('static/js/app.js')}—— 这个函数会在调试模式下自动附加?v=时间戳，生产环境可配asset_version为哈希值 - 如果用了
__STATIC__，它只是字符串替换，不会加版本号，必须换成asset()才生效
public/static/下的文件为什么总404
不是路径写错，大概率是Web服务器没放开public目录的直接访问，或者.htaccess规则干扰了静态资源路由。
ThinkPHP本身不处理静态文件，全靠Web服务器直出。Nginx和Apache配置差异大，容易漏掉关键项：
立即学习“PHP免费学习笔记（深入）”；
前端设计优化skill
下载
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
- Nginx需确认
location ^~ /static/块存在，且root指向/path/to/public，不是项目根目录 - Apache要检查
.htaccess是否被禁用，以及AllowOverride All是否生效；若用public/.htaccess，里面RewriteRule不能误匹配/static/开头的请求 - Windows下注意大小写：Linux服务器上
/Static/和/static/是两个路径，模板里写的static必须全小写
如何让CDN域名只作用于静态资源
不能全局替换__ROOT__，否则所有URL（包括接口）都走CDN，后端API会被打挂。
正确做法是只干预静态资源前缀，靠配置隔离：
- 在
config/app.php加一项'cdn_domain' => 'https://cdn.example.com' - 重写
asset()行为：在app/common.php里定义自己的my_asset()，对static/、images/等路径前缀拼接CDN域名，其余保持本地路径 - 切记不要动
__PUBLIC__常量——它是框架内置的，硬改会影响核心类加载，比如think\facade\View初始化失败
mix.js打包后资源路径对不上怎么办
Webpack输出的文件名带哈希（如app.abc123.js），但ThinkPHP的asset()还是按原名找app.js，必然404。
得让PHP侧知道真实文件名，有两条路：
- 用
laravel-mix的mix-manifest.json：Webpack构建完会生成这个文件，PHP读取它做映射。需自己写个mix()辅助函数，读public/mix-manifest.json，把asset('js/app.js')转成/js/app.abc123.js - 更轻量的做法：构建时用
--no-hash关掉哈希，改用version()函数在URL后加时间戳，虽然略弱，但够用且无额外依赖 - 别把
mix-manifest.json放在public/外，否则PHP读不到；也别用file_get_contents硬读，要考虑缓存，首次加载慢一点没关系，后续应存到runtime/cache/里
路径映射这事，框架不管，得自己兜底。没人替你读mix-manifest.json，也没人帮你判断该不该走CDN——这些逻辑一旦漏掉，上线就白屏。
