wordpress 插件中使用 `admin_notices` 钩子输出提示消息时，若未包裹在 `.wrap` 容器内，会导致通知全宽显示、遮挡侧边栏或脱离主内容区（`#wpbody-content`），根本原因是该钩子触发过早，此时 wordpress 管理后台主体结构尚未渲染。
在 wordPress 后台，标准的通知（如更新成功、设置保存提示）之所以能精准嵌入主内容区域，是因为它们被包裹在
容器中，而该容器是 wordpress 管理界面布局的核心包装器——它确保内容遵循默认栅格、留白及响应式规则，并正确位于 #wpbody-content 内部。
你当前的代码直接将
输出到 admin_notices 钩子，而此钩子在 标签后、#wpcontent 或 #wpbody-content 结构生成前即被触发，因此 dom 中通知元素会出现在 下方第一层，而非预期的管理内容区域内，造成视觉错位与样式失效（如宽度异常、z-index 冲突、无法响应 dismiss 操作等）。
✅ 正确做法：不直接在 admin_notices 中输出通知 html，而是通过自定义钩子 + 包裹容器进行可控注入。推荐采用以下结构：
php } // 2. 创建包装器：确保通知被包裹在 .wrap 内 function customer_admin_notice_wrapper() { // 仅在主内容区域渲染时执行（避免重复/无效输出） if (did_action('in_admin_header') && !doing_action('admin_notices')) { echo ''; do_action('customer_admin_notices'); echo ''; } } // 3. 注册钩子：先挂载通知逻辑到自定义钩子，再用 admin_notices 触发包装器 add_action('customer_admin_notices', 'customer_admin_notice'); // 通知内容 add_action('admin_notices', 'customer_admin_notice_wrapper'); // 容器包装 ?>? 关键说明：
- customer_admin_notices 是你自定义的动作钩子，用于解耦通知内容与容器结构；
- admin_notices 仅用于触发 customer_admin_notice_wrapper()，后者负责输出
并调用你的通知；
- 使用 esc_html() 和 esc_attr() 对输出内容做基础转义，防止 xss 风险；
- switch 替代长 if/else if 提升可读性与可维护性；
- did_action(‘in_admin_header’) 可选增强判断，确保仅在管理页头已加载后执行（进一步规避时机问题）。
⚠️ 注意事项：
- 不要在 admin_notices 回调中直接 echo 多个 .wrap，否则可能嵌套混乱；
- 若需动态控制通知显示（如仅在特定页面显示），应在 customer_admin_notice_wrapper() 中添加 get_current_screen() 判断；
- 建议配合 wp_die() 或 wp_redirect() 后的 add_settings_error() + settings_errors() 实现更规范的设置页通知流（适用于选项页面）；
- is-dismissible 类需配合 js 手动绑定关闭逻辑（WordPress 默认不自动处理自定义通知的 dismiss），如需支持关闭，请添加 javaScript 移除对应 DOM 节点并调用 wp.ajax.post() 记录用户偏好。
通过此方案，你的通知将严格对齐 WordPress 官方 ui 规范，正确显示在主内容区顶部，具备完整样式、交互与可访问性支持。