Android layout_constraintGuide XML布局中辅助线的使用

应根据需求选择：固定像素间距用app:layout_constraintguide_begin，按屏幕比例定位用android:layout_constraintguide_percent；二者不可混用，且需确保父布局宽度明确、约束正确。

ConstraintLayout 里 android:layout_constraintGuide_percent 和 app:layout_constraintGuide_begin 到底该选哪个

看名字容易以为「percent」更灵活，其实它只在父容器尺寸确定后才生效，而「begin/end」是绝对像素偏移，适合固定间距场景。比如做 16dp 左侧安全边距，用 app:layout_constraintGuide_begin="16dp" 更稳；但要做「左侧留出屏幕宽度 15%」，就得用 android:layout_constraintGuide_percent="0.15"。

常见错误：混用两者——同一根 Guideline 同时设了 begin 和 percent，后者会被忽略，IDE 还不报错。

• percent 值必须是 0～1 的小数（如 "0.25"），写成 "25%" 或 25 都会直接失效，运行时当 0 处理
• begin/end 支持 dp、sp、px，但别用 sp——字体缩放不会影响布局，反而导致错位
• 横竖屏切换时，percent 会重算，begin 不会，这点在适配折叠屏或分屏模式时得手动验证

Guideline 的 orientation 设为 "vertical" 却没起作用？检查父容器是否真正撑开了宽度

垂直辅助线本质是一条 x 轴上的竖线，它需要父 ConstraintLayout 有明确宽度才能定位。如果父布局宽设为 wrap_content，且子 View 没撑开它，Guideline 就会塌到最左边（x=0）。

典型现象：预览里线在中间，一运行就贴左；或者用 percent="0.5" 结果始终偏左。

• 确保父 ConstraintLayout 宽度至少是 0dp（即 match_constraint），且左右有约束（比如连到 parent start/end）
• 不要依赖 tools:layout_editor_absoluteX 来调试——这只是预览用，运行时完全无效
• 用 Layout Inspector 实时看 Guideline 的 mX 值，比肉眼判断准得多

为什么 View 约束到 Guideline 后不随它移动？确认用了正确的约束属性

Guideline 本身不可见、不可交互，它只是个坐标参考。View 要真正“跟”它，必须用 layout_constraintLeft_toRightOf（对 vertical Guide）或 layout_constraintTop_toBottomOf（对 horizontal Guide）这类属性，而不是随便连到 parent 再靠 margin 模拟。

常见错误：写成 app:layout_constraintLeft_toLeftOf="@id/guide" —— 这会让 View 左边贴到 Guideline 左边，但 vertical Guideline 根本没有「左边」概念，结果是未定义行为，不同版本 ConstraintLayout 表现可能不同。

• vertical Guideline 只响应 xxx_toRightOf 和 xxx_toLeftOf
• horizontal Guideline 只响应 xxx_toBottomOf 和 xxx_toTopOf
• 别给 Guideline 加 android:id 以外的任何属性（比如 background、visibility），它不支持

动态修改 Guideline 位置时，setGuidelineBegin() 和 setGuidelinePercent() 的调用时机很关键

这两方法必须在 ConstraintLayout 已完成测量之后调用，否则位置不会刷新。直接在 onCreate() 里改，大概率白忙活。

正确做法是等布局就绪，比如：

guideline.post(() -> guideline.setGuidelineBegin(100));

或者监听 ViewTreeObserver 的 onGlobalLayout()，但要注意避免重复触发。

• 用 setGuidelinePercent() 时传入 double.NaN 会清空百分比值，转而回退到 begin 模式，不是重置为 0
• 修改后记得调用 requestLayout()，虽然 ConstraintLayout 通常自动处理，但嵌套在 ScrollView 里时容易漏掉
• 如果 Guideline 是通过 LayoutInflater 加载的 xml 创建的，别试图在代码里反复 findViewById()——引用缓存住，避免重复查找开销

实际项目里最容易被忽略的，是 Guideline 的 orientation 和父布局测量状态之间的耦合关系。它不像普通 View 那样「写了就显示」，而是高度依赖 ConstraintLayout 的约束求解流程。稍微动错一个约束，整条线就失联了。