为何Xcode自动补全总是将自定义代码片段置于系统补全之上？

这种情况我之前帮朋友排查过好几次，大概率是你重新创建代码片段时，触发规则或者优先级的配置没跟上之前的设置，导致Xcode把自定义片段当成了高优先级的通用补全项。给你几个具体的排查和修复步骤，亲测有效：

1. 检查自定义代码片段的核心配置 #

这是最常见的问题，重装后创建片段很容易忽略这几个关键设置：

• 先打开Xcode的代码片段库：点击顶部菜单 Window > Libraries > Code Snippet Library（或者按快捷键 ⌘⇧L 快速调出）
• 找到你的自定义片段（比如主线程调度、@synchronized 相关的），右键选择 Edit
• 重点调整三个选项：
  • Completion Shortcut：必须设置成你想要触发的专属前缀，比如 dm（对应主线程调度）、sy（对应@synchronized）。如果留空或者设置成和系统方法相似的前缀，Xcode就会把它当成通用补全项，一输入相关字符就置顶。
  • Completion Scopes：限定片段的适用场景，比如主线程调度的片段只选「Objective-C Function/Method Body」或「Swift Function/Method Body」，别选 All。这样就不会在属性补全时乱跳出来。
  • Priority：把它从默认的 High 改成 Normal 或者 Low，让Xcode优先展示系统自带的补全项。

举个例子，主线程调度的Objective-C片段配置应该是这样：

• 快捷键：dm
• 适用范围：Objective-C Function/Method Body
• 优先级：Normal
• 代码内容：

dispatch_async(dispatch_get_main_queue(), ^{
    <#code#>
});

2. 清理Xcode缓存与索引 #

如果配置都没问题，但还是出现置顶的情况，大概率是Xcode的索引缓存混乱了。试试这几步：

• 完全关闭Xcode
• 打开访达，前往路径 ~/Library/Developer/Xcode/DerivedData，把里面的所有文件夹全部删除（这是Xcode的编译缓存，删除后会自动重建，不用担心丢失内容）
• 重新打开Xcode，按住 ⌥⇧ 点击顶部的Xcode菜单，选择 Clean Build Folder，再点击 Product > Clean
• 重启Mac后再打开Xcode，补全逻辑应该会恢复正常

3. 检查代码片段的内容格式 #

如果前两步都没用，再看看片段的代码结构：要是你的片段开头和系统某个高频方法完全一致（比如Swift里的DispatchQueue.main），即使设置了快捷键，Xcode也可能误判。这种情况下可以微调片段的代码结构，比如给占位符加个更独特的标记，不过只要快捷键设置正确，这种情况很少发生。

内容的提问来源于stack exchange，提问作者Can Poyrazoğlu