Gutenverse 不接管原生 core/image 区块，仅支持其自研 gutenverse/image 区块的对齐功能；需手动替换区块、检查 HTML 类名（如 align-center）、确保主题支持 alignwide/alignfull 并避免 CSS 冲突。
图片区块对齐失效：Gutenverse 默认不接管原生 core/image 区块
装完 gutenverse，点图片右上角对齐按钮没反应？不是你操作错，是它压根不处理 wordpress 原生的 core/image 区块。gutenverse 的对齐能力只作用于它自己提供的 gutenverse/image 区块——这是最常被跳过的前提。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 新建图片时，别用顶部「+」插入默认「图片」，而要从区块库搜
gutenverse image或在「Gutenverse」分类里选那个带蓝标图标的Image区块 - 已有的原生图片区块无法“升级”为 Gutenverse 版本，必须删掉重插
- 如果主题或插件强制加载了自定义
core/image样式（比如加了!important），会覆盖 Gutenverse 的 CSS 对齐规则
gutenverse/image 区块的对齐参数和 HTML 输出差异
Gutenverse 的图片区块把对齐拆成两层：容器级（alignfull / alignwide）和内容级（left / center / right），最终生成的 HTML 类名和原生不同，直接影响 CSS 选择器写法。
常见错误现象：自定义 CSS 里写了 .wp-block-image.aligncenter，但用了 Gutenverse 图片后样式丢了——因为实际输出的是 .wp-block-gutenverse-image.align-center。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 检查浏览器开发者工具里图片外层
div的 class 名，确认是wp-block-gutenverse-image而非wp-block-image - 对齐选项中「居中」对应
align-center（注意是短横线，不是下划线），「宽幅」对应alignwide，且两者可叠加 - 若开启「响应式对齐」开关，移动端会强制还原为
alignnone，避免溢出；关掉它才能让对齐在小屏也生效
主题 CSS 冲突导致 alignwide / alignfull 不生效
即使用了 gutenverse/image 区块并选了「宽幅」，图片仍卡在内容宽度内？大概率是主题 CSS 没给 .alignwide 和 .alignfull 设定实际宽度，或者父容器设置了 overflow: hidden。
性能与兼容性影响：Gutenverse 本身不注入额外 CSS，全靠主题支持这两个对齐类。Twenty Twenty-Four 等新主题默认支持，但很多老主题或轻量主题（如 Astra、GeneratePress 免费版）默认不支持 alignfull。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 在主题的
style.css或「自定义 CSS」后台里加一段兜底规则：.alignfull { width: 100vw; margin-left: calc(-50vw + 50%); } - 确保
body和#page（或类似主容器）没有overflow-x: hidden，否则alignfull会被截断 - 如果用子主题，优先把对齐 CSS 加到子主题
style.css，避免更新主题时丢失
用 class 属性手动覆盖对齐效果的边界情况
当区块设置和 CSS 规则打架，又不想改主题文件时，可以直接在 Gutenverse 图片区块的「高级」→「额外 CSS 类」里填自定义 class，比如 force-full-width，再用 CSS 强制控制。
容易踩的坑：这个输入框不校验 class 名合法性，如果误输空格或中文，会导致整个区块 class 属性失效，甚至破坏布局。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 只输入纯英文、数字、短横线组成的 class 名，例如
img-hero，不要写img hero或hero-img! - 配合使用
!important要谨慎：仅在调试时临时加，上线前应通过提高 CSS 选择器权重替代，比如用.wp-block-gutenverse-image.force-full-width img替代.force-full-width img { width: 100% !important; } - 如果多个图片需统一行为，优先用区块模板或全局 CSS，而不是逐个填 class——维护成本高，且易漏
真正麻烦的从来不是怎么点对齐按钮，而是搞清当前图片走的是哪套渲染路径、CSS 作用域在哪一层、以及主题有没有悄悄拦截了对齐类的传播。这些链路断一环，界面上就只是“点不动”。
