Xcode Text Editing（文本编辑）

Xcode Text Editing（文本编辑）设置说明

以下是 Xcode Text Editing（文本编辑） 设置界面的详细说明，包括 Display、Editing 和 Indentation 三个选项卡。

---

1. Display（显示）

Show（显示项）

• Line numbers（行号）
  显示代码编辑器左侧的行号。
• Code folding ribbon（代码折叠带）
  显示代码折叠按钮，用于折叠或展开代码块。
• Code structure when scrolling（滚动时显示代码结构）
  滚动代码时，显示当前代码段的结构（如函数或类）。
• Mark separators（标记分隔符）
  为函数或代码块之间的分隔线添加高亮显示。
• Dim inactive code（淡化非活动代码）
  将未激活的代码块（如条件编译中未被编译的部分）淡化处理。
• Code coverage iteration counts（显示代码覆盖率迭代计数）
  显示代码覆盖率信息（需要配置测试覆盖率工具）。
• Highlight instances of selected symbol（高亮选中符号的实例）
  高亮显示选中变量或函数的所有实例，延迟时间默认为 0.25 秒。

Documentation Comments（文档注释）

• Fade doc comment delimiters（淡化注释分隔符）
  将注释分隔符（如 /** 或 */）淡化显示。
• Fade doc comment markup delimiters（淡化文档注释标记分隔符）
  将文档注释中的标记（如 @param 或 @return）淡化显示。

Line Wrapping（换行设置）

• Wrap lines to editor width（根据编辑器宽度换行）
  勾选后，代码会根据编辑器宽度自动换行。
• Indent wrapped lines by:（换行缩进）
  设置换行代码的缩进宽度（默认：4 个空格）。

Editor Overscroll（编辑器滚动余量）

• 设置编辑器中的额外滚动空间：
  • None: 无额外滚动空间。
  • Small / Medium / Large: 提供额外的滚动空间，允许在代码末尾留空。

---

2. Editing（编辑）

Code Completion（代码补全）

• Suggest completions while typing（输入时建议代码补全）
  自动显示代码补全建议。
• Predictive code completion（预测性代码补全）
  使用 Xcode 的预测模型提供更智能的补全建议。
• Use Escape key to show completion suggestions（使用 Escape 键显示补全建议）
  按下 Escape 键显示补全提示。

Editing Features（编辑功能）

• Automatically insert closing braces（自动插入闭合括号）
  输入 { 或 ( 时自动补全对应的闭合括号。
• Close block comments（自动闭合块注释）
  输入 /* 后自动插入 */。
• Enable type-over completions（启用覆盖式补全）
  输入右括号或引号时直接跳过，而不是插入重复字符。
• Automatically balance brackets in Objective-C method calls
  在 Objective-C 方法调用中，自动平衡括号。
• Enclose selection in matching delimiters（用匹配的分隔符包围选中内容）
  选中文本后按括号键，选中内容会被括号包围。

Reformat Code（代码格式化）

• Reformat code at column（格式化列宽）
  自动格式化代码到指定列宽（默认：80 列）。
• Automatically reformat when completing code（完成代码时自动格式化）
  勾选后，在输入代码完成时自动调整格式。
• Show reformatting guide（显示格式化参考线）
  在编辑器中显示格式化列宽的参考线。

While Editing（编辑时）

• Automatically trim trailing whitespace（自动删除末尾空格）
  自动删除代码行末尾的多余空格。
• Including whitespace-only lines（包括只有空格的行）
  勾选后，清除空白行的所有空格。

Default Text Encoding（默认文本编码）

• 设置默认编码（如 Unicode (UTF-8)）。

Default Line Endings（默认换行符）

• 设置换行符类型：
  • macOS / Unix (LF)： 使用换行符 \n。
  • Windows (CRLF)： 使用回车换行符 \r\n。

Convert existing files on save（保存时转换文件编码）

• 勾选后，保存文件时将其编码转换为默认编码。

---

3. Indentation（缩进）

Prefer Indent Using（缩进方式）

• 设置代码缩进使用 Spaces（空格） 或 Tabs（制表符）。

Tab Width（制表符宽度）

• 设置制表符的显示宽度（默认：4 个空格）。

Indent Width（缩进宽度）

• 设置代码块缩进时的宽度（默认：4 个空格）。

Tab Key（Tab 键行为）

• Indents in leading whitespace（缩进首部空格）
  Tab 键用于缩进，而不是插入制表符。

Syntax-Aware Indenting（语法感知缩进）

• Indent when typing（输入时自动缩进）
  勾选后，在输入以下符号时自动调整缩进：
  • { 和 }
  • [ 和 ]
  • ( 和 )
  • # 和 Return（回车键）
• Re-Indent on paste（粘贴后自动调整缩进）
  粘贴代码后自动调整缩进。
• Indent solo { by:（独立 { 缩进）
  独立 { 时的缩进宽度（默认：4 个空格）。

Indent switch/case labels in（缩进 switch/case 标签）

• 设置以下语言的 switch/case 缩进规则：
  • Swift
  • C/Objective-C/C++

Additional Indentation Rules（附加缩进规则）

• Indent inside C++ namespace blocks
  在 C++ 命名空间块内增加缩进。
• Indent // comments one level deeper
  将单行注释缩进一级。
• Align consecutive // comments
  对齐连续的单行注释。

---

推荐设置

1. 代码清洁：

• 开启 Automatically trim trailing whitespace 和 Re-Indent on paste。
• 设置缩进使用 Spaces 和宽度为 4。

2. 代码美观：

• 设置 Reformat code at column 为 80，保持统一格式。
• 启用 Automatically balance brackets 和 Enable type-over completions。

3. 代码可读性：

• 勾选 Line numbers 和 Dim inactive code，更易于定位代码。

通过这些设置，您可以根据个人需求优化代码编辑体验，提高开发效率。