thinkphp 6.1 js/css 引入失败主因是 public 未设为 web 根目录，需正确配置 nginx/apache；模板必须用 asset() 而非硬编码路径，并确保 asset() 参数与 public 下物理路径严格一致，开发时需 router.php 支持静态文件。
ThinkPHP 6.1 的 JS 和 CSS 引入失败，90% 是因为路径没对上 Web 服务器的 public 目录结构，而不是代码写错了。你得先确认 public 是不是真的被当作了 Web 根目录——这是所有问题的起点。
确保 Nginx/Apache 把 public 当作根目录
如果服务器根目录指向的是项目根（比如 /var/www/myapp），那 /static/css/app.css 就会 404，因为文件实际在 /var/www/myapp/public/static/css/app.css。Nginx 必须配置成：
root /var/www/myapp/public;
Apache 则要在虚拟主机里设 DocumentRoot "/var/www/myapp/public"。别信“本地能跑就行”，上线 CDN 或换服务器时这一步错，全站静态资源直接消失。
模板里用 asset() 而不是硬写 /static/
写 <link href="/static/css/app.css"> 看似简单，但一旦启用了子目录部署（如 https://example.com/admin/）或绑定了 CDN 域名，路径就断了。ThinkPHP 的 asset() 函数才是唯一能自动适配这些变化的机制。
- 模板中写：
{:asset('static/css/app.css')} - PHP 代码中用：
\think\facade\Url::asset('static/js/main.js') - 必须提前在
config/app.php里配好'asset_host' => 'https://cdn.example.com'，协议不能省，否则 HTTPS 站点会拦截 HTTP 资源
public/static/ 下的路径必须和 asset() 参数严格一致
asset('css/app.css') 会拼出 /css/app.css，它对应的是 public/css/app.css；而 asset('static/css/app.css') 对应的是 public/static/css/app.css。很多人升级到 6.1 后把文件放进了 public/static/，却还调用 asset('css/app.css')，结果就是 404。
- 检查你实际存放 JS/CSS 的物理路径：是
public/static/js/还是public/js/？ - 确保
asset()里的字符串前缀（比如static/）和这个物理路径完全匹配 - Webpack 构建时若设了
output.publicPath = '/static/'，那 JS 里动态加载的 chunk 也得走同一套路径逻辑，否则import('./foo')仍可能 404
开发时用 php -S 启动，必须配 router.php
内置服务器默认不识别 public/ 下的子目录，所有请求都会进 public/index.php，导致 JS/CSS 返回 HTML 内容或 404。你得手动写一个 router.php 拦截静态请求：
if (preg_match('/\.(?:png|jpg|jpeg|gif|css|js|woff2|ttf)$/', $_SERVER['REQUEST_URI'])) {
$file = __DIR__ . '/public' . $_SERVER['REQUEST_URI'];
if (is_file($file)) {
return false; // 让 php -S 直接返回该文件
}
}
require __DIR__ . '/public/index.php';
然后启动命令是：php -S localhost:8000 router.php。漏掉这一步，开发环境就和生产环境行为不一致，调试时会浪费大量时间在“为什么线上不行但本地可以”上。
最常被忽略的其实是 asset() 和物理路径的映射关系——它不自动扫描目录，也不做路径转换，你给什么，它就拼什么。哪怕只多一个斜杠、少一个 static/ 前缀，结果就是 404。别猜，直接用 curl -I http://localhost/static/css/app.css 看响应头和状态码，比翻文档快得多。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
