最直接切换堆叠页的方式是调用setCurrentIndex()，它同步执行并立即更新currentIndex()，但需校验索引有效性以防静默失败；也可用setCurrentWidget()按指针切换，避免索引错位风险。
QStackedWidget::setCurrentIndex() 切换最直接
直接调用 setCurrentIndex() 是切换堆叠页最常用也最可靠的方式。它接受一个整数索引（从 0 开始），对应 addWidget() 添加的顺序。注意：如果传入超出范围的索引（比如 -1 或 ≥ count()），Qt 不会报错，但页面不会变化，也不会触发 currentChanged 信号——这容易误以为“调用失败”，其实是静默忽略。
实操建议：
- 切换前先检查索引有效性：
if (index >= 0 && index count()) { stackedWidget->setCurrentIndex(index); } - 如果依赖用户输入或外部数据生成索引，务必做边界校验，否则逻辑会“卡住”却无提示
- 该方法是同步执行，调用后
currentIndex()立即返回新值，适合需要立即响应的场景
用 setCurrentWidget() 按指针切换更安全
当你持有某个子控件的指针（比如通过 findChild<qwidget>()</qwidget> 或构造时保存），用 setCurrentWidget() 更直观且避免索引错位风险。它内部会自动查找该 widget 所在的索引并切换，即使你中途插入/移除了其他页面，也不影响目标页的切换逻辑。
常见错误现象：页面顺序变动后，硬编码的 setCurrentIndex(2) 突然切到了错误页面——这就是索引耦合导致的维护陷阱。
使用场景：
- 多个页面由不同模块创建，主窗口只负责堆叠和跳转，不关心顺序
- 需要从子页面内部触发返回上一页（例如子页 emit 信号，主窗口用
setCurrentWidget(prevPage)） - 配合
removeWidget()动态管理页面时，用指针比用索引更稳定
currentChanged 信号怎么监听和防重复触发
currentChanged 信号在页面真正切换完成后发出，参数是新页面的索引。但它有个关键细节：**首次 show() 时也会触发一次**（默认显示第 0 页）。如果你在构造完就 connect 信号，又在槽函数里执行初始化逻辑，可能被意外触发两次——一次是初始显示，一次是手动切换。
性能与兼容性影响：该信号是 Qt::QueuedConnection 类型（跨线程安全），但在主线程中基本无延迟；不过若槽函数耗时，会阻塞后续 UI 响应。
实操建议：
- 初始化完成后才 connect 信号，或用
blockSignals(true)临时屏蔽首次触发 - 槽函数中优先用
widget(index)获取当前页指针，而不是依赖外部变量缓存，避免状态不同步 - 不要在
currentChanged槽里再调用setCurrentIndex()，否则可能引发无限循环（尤其当判断条件不稳时）
切换动画不是内置功能，得自己加
QStackedWidget 本身不提供淡入、滑动等动画效果，所有“带动画的切换”都需手动实现：隐藏旧页、显示新页、用 QPropertyAnimation 或 QParallelAnimationGroup 控制 opacity/geometry 变化，最后调用 raise() 确保层级正确。
容易踩的坑：
- 动画期间用户再次点击切换按钮，未做防抖会导致动画冲突、页面错乱
- 直接对
QStackedWidget设置 opacity 动画会影响所有子页，必须作用于具体 widget - 使用
setGeometry()做滑动时，记得在动画结束时重置新页 geometry，否则后续布局可能异常
简单示例思路：保存当前页指针 oldWidget 和新页指针 newWidget → newWidget->show() → 启动动画 → 动画完成时调用 setCurrentWidget(newWidget) 并清理 oldWidget 的临时样式。
复杂点往往不在切换动作本身，而在动画与事件响应、焦点管理、以及 resize 时的几何重算之间如何协同——这些细节不显眼，但一出问题就难定位。
