​

## 1. 工具定位与能力总览

​

### 1.1 锚点工具（Anchor Studio）做什么

锚点工具专注于 **RectTransform 锚点/枢轴/偏移** 的批量操作，包含：

​

- 锚点快速对齐（锚点跟随当前矩形、矩形贴合锚点）

- 点位与拉伸预设批量应用

- 镜像、安全区应用、响应式预览

- 布局快照复制/粘贴、预设资源化

- 规则扫描、自动修复、报告导出（JSON）

- 诊断扫描与常见问题修复

​

### 1.2 布局工具做什么

布局工具专注于 **LayoutGroup / ContentSizeFitter / LayoutElement** 体系，包含：

​

- 一键创建布局容器

- 一键预设（纵向列表、横向导航、网格相册）

- 横向/纵向/网格参数配置与批量应用

- 外边距批量应用

- 子项 LayoutElement 批量覆盖与批量移除

- 布局组件清理、子项快速选中、参数反向读取

​

---

​

## 2. 打开方式

​

### 2.1 菜单入口

- 锚点工具：`HT/UI/锚点与布局工具/锚点工具`

- 布局工具：`HT/UI/锚点与布局工具/布局工具`

​

### 2.2 快捷操作（无需打开主窗口）

路径：`HT/UI/锚点与布局工具/快捷操作/...`

​

- 锚点对齐到当前矩形：`Ctrl/Cmd + Shift + Alt + Q`

- 矩形贴合锚点：`Ctrl/Cmd + Shift + Alt + W`

- 应用当前安全区：`Ctrl/Cmd + Shift + Alt + A`

- 规则扫描（默认）

- 规则自动修复（默认）

​

### 2.3 Scene 视图 Overlay（Unity 2021.2+）

`SceneView` 中可启用“锚点工具”Overlay，提供按钮直达：

​

- 打开锚点工具

- 打开布局工具

- 快捷锚点动作

- 规则扫描/自动修复

- 选中当前收集到的 RectTransform

​

---

​

## 3. 通用机制（两工具都建议先理解）

​

### 3.1 目标收集规则

- 目标来源于当前 Selection。

- 可配置：

- 包含子级

- 包含未激活对象

- 目标会去重并按层级路径排序，便于批处理稳定输出。

​

### 3.2 批处理结果统计

每次操作均有结果统计：

​

- `已变更`：目标确实发生变化

- `已跳过`：不满足条件或没有变化

- `失败`：执行异常

​

若 `已变更 = 0`，通知里会尽量附带首条原因（例如“受驱动对象已跳过”）。

​

### 3.3 可能被跳过的典型原因

- 目标为空

- 目标父级不是 RectTransform

- 启用了“跳过受驱动对象”，而对象被 LayoutGroup/ContentSizeFitter/驱动系统控制

- 参数与当前值一致（没有变化）

​

### 3.4 Undo 与安全性

- 两工具都使用 Undo 组，支持一次撤销整批操作。

- 重要建议：先小范围验证再全量批处理。

​

---

​

## 4. 锚点工具（完整详解）

​

## 4.1 界面布局（新版双栏）

- 左栏（固定导航）：工作模式、目标范围、批处理策略、高频动作、功能页切换

- 右栏（主内容）：当前功能页详细配置（可滚动）

​

这套布局的核心目标是：减少“一个长页面来回滚动”。

​

### 4.2 左栏区域说明

​

#### A. 工作模式

- **简洁模式**：只保留高频页（快捷、响应式、规则）

- **专业模式**：显示全部页（快捷、高级、响应式、预设、规则、诊断）

​

#### B. 目标范围

- 包含子级

- 包含未激活对象

- 预览目标列表（最多展示一部分）

​

#### C. 批处理选项

- 保持矩形几何形状（推荐开）

- 跳过受驱动/布局控制的矩形（默认策略建议开）

- 将锚点限制到 `[0,1]`

- 应用后对布局值取整

​

#### D. 一键策略

- **安全策略（推荐）**：

- 保持几何 = 开

- 跳过受驱动 = 开

- 锚点限制 = 关

- 布局取整 = 关

- **强力修正策略**：

- 保持几何 = 开

- 跳过受驱动 = 关

- 锚点限制 = 开

- 布局取整 = 开

​

#### E. 高频动作（高亮按钮）

- 锚点跟随当前矩形

- 矩形贴合锚点（偏移归零）

- 全拉伸填充父级

​

#### F. 功能页侧栏

点击左栏“功能页”按钮切换右栏内容，当前页高亮显示。

​

---

​

### 4.3 右栏功能页详解

​

### 4.3.1 快捷页

​

#### 推荐流程

1. **锚点跟随当前矩形**：把当前可见矩形位置换算成锚点

2. **矩形贴合锚点**：offsetMin/offsetMax 归零

3.（可选）全拉伸填充父级

4.（可选）应用当前游戏视图安全区

​

#### 点位锚点预设

九宫格：左上/上/右上/左/中/右/左下/下/右下。

​

可选项：**点位预设时同步枢轴到同一位置**。

- 开启后，点位预设会同时把 pivot 对齐到该点位。

​

#### 拉伸预设

- 横向拉伸

- 纵向拉伸

- 全拉伸

- 顶部拉伸

- 底部拉伸

- 左侧拉伸

- 右侧拉伸

​

#### 镜像

- 水平镜像锚点

- 垂直镜像锚点

​

---

​

### 4.3.2 高级页

​

#### 自定义锚点/枢轴

- 从首个选中对象读取

- 手动输入锚点最小值、锚点最大值、枢轴

- 应用自定义锚点

- 应用枢轴

​

#### 布局剪贴板（快照）

- 复制首个选中对象布局

- 粘贴模式：

- 仅锚点和枢轴

- 完整布局

- 仅偏移

- 将布局粘贴到当前选择

- 清空剪贴板

​

#### 工具

- 限制锚点到 `[0,1]`

- 布局值取整

​

---

​

### 4.3.3 响应式页

​

#### 预览参数

- 配置（内置机型档）

- 按安全区子节点进行模拟

- 是否显示全部配置结果表

​

#### 当前配置预览信息

- 分辨率

- 归一化安全区

- 容器矩形

- 目标矩形

- 是否位于容器内

​

#### 安全区应用

- 应用当前配置安全区（拉伸填充）

- 读取当前游戏视图安全区

- 自定义归一化安全区并应用

​

---

​

### 4.3.4 预设页

​

#### 预设资源操作

- 指定/创建 `AnchorStudioLayoutPreset`

- 从首个选中对象创建新预设资源

- 编辑预设描述

- 设定默认粘贴模式

- 从首个选中对象捕获快照

- 应用预设到当前选择（可覆盖粘贴模式）

​

#### 快照显示

会显示锚点最小值、最大值、枢轴等关键字段，便于核对。

​

---

​

### 4.3.5 规则页

​

#### 目标

先扫描风险，再自动修复可修复项。

​

#### 简洁模式 vs 专业模式

- 简洁模式：隐藏模板批量管理，聚焦扫描与修复

- 专业模式：显示规则模板、模板组、批量切换能力

​

#### 规则检查项

- 检查锚点

- 检查枢轴

- 检查缩放

- 检查受驱动状态

- 检查父级布局控制器

- 检查接近零尺寸

- 检查布局小数值

​

#### 自动修复项

- 修复锚点（限制/重排）

- 修复枢轴范围

- 修复缩放到 1

- 修复布局小数值

​

#### 核心按钮

- 执行规则扫描

- 自动修复发现项

- 导出规则报告（JSON）

​

#### 发现项列表

可按“仅显示可自动修复项”过滤。

​

#### 规则模板（专业模式）

- 按当前设置创建模板

- 从模板加载设置

- 保存当前设置到模板

​

#### 模板组批量切换（专业模式）

- 创建模板组

- 当前模板加入模板组

- 上一个/下一个模板

- 切换时自动扫描

- 循环切换

- 批量扫描全部模板

​

---

​

### 4.3.6 诊断页

​

#### 扫描

执行诊断后按严重度汇总：错误/警告/提示。

​

#### 快速修复

- 修复缩放 = 1

- 修复：限制锚点

- 修复：布局取整

​

#### 诊断项示例

- 父级不是 RectTransform

- 本地缩放非 `(1,1,1)`

- 锚点最小值大于最大值

- 锚点越界

- 受驱动对象

- 父级布局控制器

- 尺寸接近 0

​

---

​

## 5. 布局工具（完整详解）

​

### 5.1 界面布局（新版双栏）

- 左栏（入口区）：工作模式、生效范围、创建容器、一键预设、维护工具

- 右栏（配置区）：布局组参数、外边距、子项批处理

​

### 5.2 顶部信息

会显示：

- 当前目标路径

- 已选目标数

- 生效目标数（受“生效范围”影响）

​

### 5.3 工作模式与生效范围

​

#### 工作模式

- 简洁模式：默认隐藏部分复杂区块，可按需展开

- 专业模式：完整配置全部可见

​

#### 生效范围

- 仅当前目标

- 全部已选目标

​

> 这是布局工具的关键：你可以一键对多目标批量应用同一套布局参数。

​

---

​

### 5.4 左栏入口区

​

### 5.4.1 创建布局容器

参数：

- 容器名称

- 作为当前选中对象的子级创建

- 创建后自动应用当前布局设置

​

行为：

- 自动创建 RectTransform，锚点设为全拉伸，偏移归零

- 可选择创建后立即套用当前布局参数

​

### 5.4.2 一键布局预设

- 纵向列表

- 横向导航

- 网格相册

​

点击预设只会改“参数草稿”，需要再点 **应用到生效目标** 才真正生效。

​

### 5.4.3 工具

- 只重建当前目标布局

- 移除生效目标上的布局组件（LayoutGroup/Fitter/LayoutElement）

- 选中生效目标的所有子项 RectTransform

​

---

​

### 5.5 右栏配置区

​

### 5.5.1 布局组设置

​

#### 基础

- 布局类型：横向布局 / 纵向布局 / 网格布局

- 显示高级布局参数

-（高级）应用前移除当前节点上的其他布局组

-（高级）应用后立即重建布局

​

#### 通用

- 子项对齐（已中文化）：

- 左上、上中、右上

- 左中、居中、右中

- 左下、下中、右下

- 内边距：左/右/上/下

​

#### 横向/纵向专用

- 间距

- 控制子项宽度

- 控制子项高度

-（高级）考虑子项 X/Y 缩放

-（高级）强制拉伸宽度/高度

​

#### 网格专用

- 单元格大小

- 网格间距

-（高级）起始角：左上开始/右上开始/左下开始/右下开始

-（高级）填充主轴：先横向后换行 / 先纵向后换列

-（高级）约束模式：灵活 / 固定列数 / 固定行数

-（高级）约束数量

​

#### 内容尺寸适配器（ContentSizeFitter）

- 启用内容尺寸适配器

- 水平适配（已中文化）：不约束 / 最小尺寸 / 首选尺寸

- 垂直适配（已中文化）：不约束 / 最小尺寸 / 首选尺寸

-（高级）禁用时移除已有内容尺寸适配器

​

#### 其他

- 应用布局时同步应用外边距

- 查看生效目标当前布局状态（每个目标是否有 LayoutGroup/Fitter）

- 读取当前目标配置（反向读取已有组件参数）

- 应用布局到生效目标（批量）

​

---

​

### 5.5.2 外边距

- 左/右/上/下（float）

- 应用外边距到生效目标

​

实现方式：写入 `offsetMin` / `offsetMax`。

​

---

​

### 5.5.3 子项 LayoutElement 批量设置

​

可选覆盖项（勾选后生效）：

- 忽略布局

- 最小宽度/高度

- 首选宽度/高度

- 弹性宽度/高度

- 布局优先级

​

其他选项：

- 递归到所有后代

- 包含未激活对象

​

按钮：

- 应用到子项

- 移除子项 LayoutElement

​

---

​

## 6. 规则系统细节（锚点工具）

​

### 6.1 规则项与严重度

- 缺少父级矩形变换（错误）

- 锚点超出范围（警告，可修复）

- 锚点最小值 > 最大值（错误，可修复）

- 枢轴超出范围（警告，可修复）

- 缩放不是 1（警告，可修复）

- 受驱动对象（警告，不可自动修复）

- 父级布局控制器（警告，不可自动修复）

- 尺寸接近 0（提示）

- 布局值含小数（提示，可修复）

​

### 6.2 自动修复映射

- 锚点问题 -> 限制锚点到 `[0,1]`

- 枢轴问题 -> 限制枢轴到 `[0,1]`

- 缩放问题 -> 规范化缩放 `(1,1,1)`

- 小数问题 -> 布局值取整

​

### 6.3 报告导出

- 可导出 JSON，包含时间、统计汇总、每条发现项明细（目标路径、规则、严重度、可修复性、消息等）

​

---

​

## 7. 推荐工作流（实战）

​

### 7.1 新建页面（从无到有）

1. 打开布局工具 -> 创建布局容器

2. 用一键预设初始化（如纵向列表）

3. 在右栏调节布局参数并应用到生效目标

4. 打开锚点工具，做安全区适配与点位微调

5. 执行规则扫描，修复可修复项，导出报告存档

​

### 7.2 旧页面批量修正

1. 锚点工具左栏选择强力修正策略（按需）

2. 启用包含子级，批量执行“限制锚点/布局取整”

3. 规则扫描 -> 自动修复 -> 复扫

4. 对高风险页导出 JSON 报告

​

### 7.3 多容器统一布局

1. 布局工具设置生效范围为“全部已选目标”

2. 先在一个目标上调好参数

3. 点“读取当前目标配置”同步参数

4. 一键应用布局到生效目标

​

---

​

## 8. 常见问题与排查

​

### Q1：按钮点了没反应？

优先检查：

- 是否真的有生效目标

- 是否被“跳过受驱动对象”拦截

- 是否父级不是 RectTransform

- 是否参数相同导致“没有变化”

​

### Q2：改完又被还原？

大概率是布局系统或脚本驱动：

- 父级有 LayoutGroup/ContentSizeFitter

- 目标 drivenByObject 不为空

​

处理：

- 临时关闭相关驱动再调整，或

- 在最终驱动组件参数层面解决

​

### Q3：为什么建议先小范围测试？

批处理覆盖范围广，先在单个目标验证可避免大面积返工。

​

### Q4：为什么有些对象被跳过？

工具会主动避免危险场景（空目标、结构不合法、受驱动等），这是安全机制。

​

---

​

## 9. 团队落地建议

​

- 建议统一使用“安全策略”作为默认流程

- 建议每次大规模批处理前做场景备份或提交版本控制

- 建议把常用规则配置做成模板，按页面类型切换

- 建议在 CI 或提测前执行一次规则扫描并保存报告

​

---

​

## 10. 附录：关键名词速查

​

- **锚点（Anchor）**：相对父级矩形的归一化定位基准

- **枢轴（Pivot）**：自身旋转/缩放/定位中心点

- **偏移（Offset）**：在锚点框架下的边距偏移量

- **受驱动（Driven）**：值被布局系统或脚本控制，手动改动可能被覆盖

- **布局组（LayoutGroup）**：横向/纵向/网格自动排版组件

- **内容尺寸适配器（ContentSizeFitter）**：根据内容驱动自身尺寸

- **布局元素（LayoutElement）**：给子项声明最小/首选/弹性尺寸

​

---