Bootstrap 5 分页需严格遵循结构规范：用<nav>包裹<ul class="pagination">，页码项为<li class="page-item">，链接为<a class="page-link">；禁用态须同时加disabled类和aria-disabled="true"；当前页必须用<a>而非<span>；JS需阻止默认跳转并委托监听点击事件。
Bootstrap 5 的 pagination 类怎么用才不踩坑
直接套 Bootstrap 5 官方 pagination 类就能跑，但常见问题不是“没样式”，而是「页码对不齐」「禁用态点击仍生效」「响应式断点失效」。关键不在加不加类，而在结构是否严格符合文档要求。
必须用 <nav> 包裹，且内部必须是 <ul class="pagination">，每个页码项必须是 <li class="page-item">，链接必须是 <a class="page-link"> —— 少一个 class 或错一层嵌套，CSS 就会漏样式或破坏垂直居中。
- 禁用状态必须写
class="page-item disabled"+<a class="page-link" aria-disabled="true">，只加disabled属性没用 - 当前页必须是
class="page-item active"+<a class="page-link">（不是<span>），否则背景色和边框不会生效 - 不要在
.page-link上额外加display: block或float，会破坏 Flex 布局导致换行
如何让页码紧凑显示又支持移动端折叠
Bootstrap 5 默认页码间距较大，PC 端看着松散，移动端又容易溢出。不用改源码，靠内置的 spacing 工具类和响应式断点就能调。
缩小间距：给 <ul class="pagination"> 加 gap-1（比默认 gap-2 更紧凑）；隐藏中间页码：用 d-none d-md-flex 控制「仅在中屏及以上显示」；上一页/下一页按钮可加 px-3 微调内边距。
立即学习“前端免费学习笔记（深入）”；
<nav>
<ul class="pagination gap-1">
<li class="page-item"><a class="page-link px-3" href="#">«</a></li>
<li class="page-item d-none d-md-flex"><a class="page-link" href="#">1</a></li>
<li class="page-item active"><a class="page-link" href="#">2</a></li>
<li class="page-item d-none d-md-flex"><a class="page-link" href="#">3</a></li>
<li class="page-item"><a class="page-link px-3" href="#">»</a></li>
</ul>
</nav>
自定义颜色和圆角但不想动 Sass 变量
如果只是临时改一两个页面的分页样式，别碰 $pagination-border-radius 这类 Sass 变量——编译麻烦还影响全局。直接用 Bootstrap 提供的 utility 类组合更安全。
- 圆角：用
rounded-pill（胶囊形）或rounded-2（4px 圆角），避免写border-radius: 8px - 颜色：当前页背景用
bg-primary，文字用text-white；禁用态文字用text-muted - 悬停效果：Bootstrap 默认已有
:hover，但若想强化，加shadow-sm到.page-link即可，无需写伪类
为什么点击页码没反应？JS 绑定要注意什么
CSS 分页组件本身不处理点击逻辑，这是最容易被忽略的一点。Bootstrap 的 pagination 只是样式层，<a href="#"> 默认会跳到页面顶部，看起来像“没反应”。
必须手动阻止默认行为，并绑定事件。尤其注意：不要用 onclick="" 内联写法，要统一用 JS 监听委托，否则动态插入的页码项无法响应。
document.addEventListener('click', function (e) {
if (e.target.classList.contains('page-link')) {
e.preventDefault();
const pageNum = e.target.textContent.trim();
// 执行你的分页加载逻辑，比如 fetch(`/api?page=${pageNum}`)
}
});
如果用了 jQuery，记得用 $(document).on('click', '.page-link', ...) 而非 $('.page-link').on('click', ...)，否则新渲染的页码不会触发。
真正麻烦的从来不是写几行 CSS，而是结构合规性、JS 事件委托范围、以及移动端 touch 与 click 的兼容处理——这些细节漏掉一个，用户就卡在第一页不动。
