Visual Attributed String for Mac 核心功能与操作全解

Visual Attributed String for Mac 是一款专为 macOS 开发者设计的富文本属性字符串可视化编辑与调试工具。它允许开发者通过直观的图形界面创建、编辑和预览 NSAttributedString 或 AttributedString（SwiftUI），并生成可直接在代码中使用的 Swift 或 Objective-C 代码片段，极大提升了处理复杂文本样式的效率。

一、 软件核心界面与工作区详解

启动软件后，主界面主要分为五个核心区域，共同构成了一个高效的可视化编辑环境。

1. 顶部工具栏

位于窗口顶部，包含项目的基础操作按钮：

• 新建：创建一个全新的属性字符串项目。
• 打开：打开一个已保存的 .vastring 项目文件。
• 导出：将当前项目导出为代码文件或纯文本。
• 预览切换：在实时预览视图和代码视图之间切换。

2. 左侧属性面板

这是编辑的核心区域，采用层级列表结构，用于管理字符串的各个片段（Run）。

• Run 列表：每个列表项代表一段具有独立属性的文本。可以在这里添加、删除、排序文本片段。
• 属性检查器：选中某个 Run 后，此区域会显示该片段的所有属性设置，如字体、颜色、段落样式、下划线、阴影等，所有修改均实时生效。

3. 中央编辑与预览区

此区域提供两种视图模式：

• 预览视图：实时渲染属性字符串的最终显示效果，与在 App 中呈现的效果一致。
• 代码视图：实时显示根据当前设计生成的 Swift 或 Objective-C 源代码。代码会随着左侧的编辑而同步更新。

4. 右侧代码输出面板

固定显示完整的、可复制的最终代码。通常包含初始化整个属性字符串所需的全部代码。用户可直接全选复制并粘贴到 Xcode 项目中。

5. 底部状态栏

显示当前项目的基本信息，如字符总数、当前选中的 Run 的字符范围等。

二、 完整操作流程：从创建到导出

步骤 1：创建新项目

方法1：启动软件后，会自动提供一个空白项目。
方法2：通过菜单栏 “File” → “New” 或使用快捷键 Command (⌘) + N 创建。

步骤 2：添加与编辑文本片段

1. 在左侧属性面板的 Run 列表底部，点击 “+” 按钮，添加一个新的文本片段。
2. 在新增的 Run 项中，双击“Text”字段，输入所需的文本内容，例如“Hello”。
3. 保持该 Run 为选中状态，在下方属性检查器中调整样式。
   • 设置字体：点击 Font 下拉菜单，选择“Helvetica Neue”，大小设为 24。
   • 设置颜色：点击 Foreground Color 颜色井，在弹出的颜色选择器中选取蓝色。
4. 重复步骤 1-3，添加第二个 Run，输入“World！”，并为其设置红色、粗体样式。

步骤 3：调整全局与段落属性

• 在 Run 列表顶部，选中 “Base Attributes”，此处设置的属性（如默认字体、对齐方式）将作为所有 Run 的默认值，除非在单个 Run 中被覆盖。
• 在单个 Run 的属性检查器中，找到 “Paragraph Style” 区域，可以设置行距、对齐方式（如居中对齐）、首行缩进等。

步骤 4：实时预览与调试

所有编辑操作均会即时反馈在中央的预览视图中。通过滚动或调整预览区大小，可以检查不同条件下的显示效果。使用中央区域上方的选项卡可切换到代码视图，核对生成的代码逻辑。

步骤 5：导出最终代码

1. 确认预览效果符合预期。
2. 在右侧代码输出面板中，顶部可以选择语言（Swift / Objective-C）和目标框架（UIKit / AppKit / SwiftUI）。
3. 面板中的代码已自动更新。直接全选（⌘ + A）并复制（⌘ + C）。
4. 切换到 Xcode，将代码粘贴到需要的位置即可。
5. （可选）如需保存项目文件以便日后修改，可通过 “File” → “Save”（⌘ + S）保存为 .vastring 格式。

三、 常用功能进阶技巧

1. 快速复制文本片段属性

选中一个已设置好样式的 Run，右键点击，选择 “Copy Run”（或 ⌘ + C），然后右键在列表中选择 “Paste Run”（或 ⌘ + V）。新粘贴的 Run 将继承所有属性，只需修改文本内容即可快速创建风格一致的片段。

2. 使用“Base Attributes”提高效率

对于项目中大多数片段共享的属性（如主字体、行距），务必在 Base Attributes 中设置。这能保持代码的整洁，并便于全局修改。单个 Run 只需设置与基类不同的覆盖属性。

3. 利用变量（Placeholders）进行动态内容设计

在 Run 的文本内容中，可以插入如 {{name}} 这样的占位符。软件在生成代码时，会将其处理为可在运行时替换的字符串变量。这对于设计邮件模板、通知消息等场景非常有用。

4. 精细调试段落样式

当文本布局出现异常时，优先检查段落样式。在属性检查器中展开 Paragraph Style，特别注意 lineHeightMultiple（行高倍数）和 paragraphSpacing（段间距）这两个容易产生累积影响的属性。

四、 常见问题与解决方案

问题 1：预览效果与最终在 Xcode 中运行的效果不一致

解决方案：首先检查右侧代码输出面板顶部的框架和语言选择是否与你的目标项目匹配（例如，SwiftUI 项目应选择 SwiftUI 框架）。其次，确保复制了完整的代码，包括所有变量的初始化部分。

问题 2：添加的阴影（Shadow）效果在预览中看不到

解决方案：检查阴影的偏移量（Offset）是否设置过小。同时，确认阴影颜色（Color）的不透明度（Alpha）不是 0，且模糊半径（Blur）大于 0。一个常见的起始设置是：偏移 (2, 2)，模糊半径 2，颜色为半透明黑。

问题 3：生成的代码过于冗长或包含不必要的默认属性

解决方案：在软件设置中（“Visual Attributed String” → “Preferences”），查找代码生成选项，可以尝试勾选“Omit Default Values”或类似选项，以生成更简洁的代码。

问题 4：如何实现文本的垂直居中（特别是配合图标时）

解决方案：这不是通过字体属性直接设置的。你需要调整该 Run 的 Baseline Offset 属性。正值向上偏移，负值向下偏移。通过微调此值，可以精确控制文本的垂直位置。

五、 快捷键汇总表

“`