Bootstrap 5 分页需严格遵循结构规范：用包裹，页码项为，链接为；禁用态须同时加disabled类和aria-disabled="true"；当前页必须用而非；JS需阻止默认跳转并委托监听点击事件。
Bootstrap 5 的 pagination 类怎么用才不踩坑
直接套 Bootstrap 5 官方 pagination 类就能跑，但常见问题不是“没样式”，而是「页码对不齐」「禁用态点击仍生效」「响应式断点失效」。关键不在加不加类，而在结构是否严格符合文档要求。
必须用 包裹，且内部必须是 ，链接必须是 —— 少一个 class 或错一层嵌套，CSS 就会漏样式或破坏垂直居中。
- 禁用状态必须写
class="page-item disabled"+，只加disabled属性没用 - 当前页必须是
class="page-item active"+（不是），否则背景色和边框不会生效 - 不要在
.page-link上额外加display: block或float，会破坏 Flex 布局导致换行
如何让页码紧凑显示又支持移动端折叠
Bootstrap 5 默认页码间距较大，PC 端看着松散，移动端又容易溢出。不用改源码，靠内置的 spacing 工具类和响应式断点就能调。
缩小间距：给 gap-1（比默认 gap-2 更紧凑）；隐藏中间页码：用 d-none d-md-flex 控制「仅在中屏及以上显示」；上一页/下一页按钮可加 px-3 微调内边距。
自定义颜色和圆角但不想动 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 只是样式层， 默认会跳到页面顶部，看起来像“没反应”。
必须手动阻止默认行为，并绑定事件。尤其注意：不要用 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}`)
}
});
如果用了
$(document).on('click', '.page-link', ...) 而非 $('.page-link').on('click', ...)，否则新渲染的页码不会触发。
真正麻烦的从来不是写几行 CSS，而是结构合规性、JS 事件委托范围、以及移动端 touch 与 click 的兼容处理——这些细节漏掉一个，用户就卡在第一页不动。
