ThinkPHP 的 public 目录是 Bootstrap 资源唯一合法落点，静态文件须放 public/static/ 下并用绝对路径引用；模板需继承 layout 统一引入 CSS/JS；表单与分页必须用 url() 函数生成地址；自定义分页应重写渲染模板而非修改源码。
ThinkPHP 的 public 目录是 Bootstrap 资源的唯一合法落点
Bootstrap 的 CSS、JS、字体等静态资源不能放在 application/ 或 runtime/ 下，否则会被路由拦截或暴露敏感路径。所有前端文件必须放进 public/ 目录（ThinkPHP 5+ 默认入口目录），这是唯一被 Web 服务器直接服务的公开路径。
常见错误现象：GET http://localhost/static/css/bootstrap.min.css 404，本质是路径没对齐到 public/static/；或者误把 bootstrap.min.js 放进 view/ 模板里导致多次加载、$ 冲突。
- 正确做法：在
public/下建static/bootstrap/，把bootstrap.min.css和bootstrap.bundle.min.js放进去 - HTML 中引用必须用绝对路径前缀：
<link rel="stylesheet" href="/static/bootstrap/bootstrap.min.css"> - 别用
./或../开头的相对路径——ThinkPHP 的 URL 重写会让它失效 - jQuery 必须在 Bootstrap JS 之前加载，且版本要匹配（Bootstrap 5 不再依赖 jQuery，但很多 TP 插件仍需）
模板中用 {__CONTENT__} 套 Bootstrap 布局，别硬写 HTML 结构
ThinkPHP 的模板继承机制（{layout name="layout" /}）和 Bootstrap 的栅格系统天然契合。直接在 view/layout.html 里写好 .container、.row、.col-md-* 结构，子模板只填业务内容，避免每页重复写响应式容器。
容易踩的坑：在控制器中用 $this->fetch() 加载模板时，如果没指定 layout，或子模板里漏了 {extend name="layout" /}，整个 Bootstrap 样式会“突然消失”——其实只是没套上外层容器和 CSS 引用。
立即学习“PHP免费学习笔记（深入）”；
-
view/layout.html开头必须有<link>和<script></script>引入，且放在和前 - 子模板第一行写
{extend name="layout" /}，第二行开始才是{block name="content"}...{/block} - 不要在子模板里重复引入 Bootstrap，会导致样式覆盖或 JS 初始化两次
表单提交和分页必须用 ThinkPHP 的 url() 函数生成地址
Bootstrap 的 <form></form> 和分页组件（如 .pagination）需要真实可访问的 PHP 路由地址。手写 action="/index.php?s=/user/login" 或 href="?page=2" 在开启 URL 重写后必然 404。
ThinkPHP 的 url() 函数会自动适配当前路由配置（PATHINFO 或兼容模式），是唯一安全的链接生成方式。
- 表单提交：
<form action="%7B:url('User/login')%7D" method="post"></form> - 分页链接：
<a href="%7B:url('User/index',%20['page'%20=>%20%24page])%7D">{$page}</a> - 若使用 Bootstrap 的 JavaScript 分页插件（如 DataTables），需用 AJAX 请求
{:url('User/data')}接口，后端返回 JSON，而非渲染整页 HTML - 注意：TP5.1+ 的
url()默认不带index.php，但 Nginx/Apache 配置必须启用重写，否则链接无效
自定义分页样式时，别改 ThinkPHP 的 Page 类源码
ThinkPHP 自带的 think\Paginator 渲染出的是纯 <ul><li><a></a></li></ul> 结构，和 Bootstrap 的 .pagination 类名不匹配。强行在模板里加 class 会破坏语义，且每次升级框架都得重改。
真正可持续的做法是继承并重写渲染模板，而不是 patch 源码。
- 在
view/下新建common/paginate.html，按 Bootstrap 5 的结构写：<nav aria-label="Page navigation"><ul class="pagination">{volist name="pages" id="page"}<li class="page-item{if $page.current} active{/if}"><a class="page-link" href="%7B%24page.url%7D">{$page.number}</a></li>{/volist}</ul></nav> - 控制器中调用分页时传入模板：
$list->render('common/paginate') - 确保
$list是Paginator实例（如Db::name('user')->paginate(10)返回的） - 别动
thinkphp/library/think/Paginator.php—— 升级时会被覆盖，且违反框架约定
最易被忽略的是：Bootstrap 5 的分页需要 aria-label 和语义化 class，而 ThinkPHP 默认输出没有。不补上这些，会影响可访问性检测和部分自动化测试工具的通过率。
