CodeEditSourceEditor 智能代码补全实战用 CodeSuggestionDelegate 打造提示窗口【免费下载链接】CodeEditSourceEditorA code editor view written in Swift powered by tree-sitter.项目地址: https://gitcode.com/gh_mirrors/co/CodeEditSourceEditorCodeEditSourceEditor 是一款基于 Swift 与 tree-sitter 构建的现代代码编辑器视图组件它的代码补全提示窗口设计得非常克制而优雅——编辑器本身不内置任何词库所有补全数据都通过CodeSuggestionDelegate协议交给开发者自由发挥。无论你是想在 macOS 应用里接入 AI 补全、基于符号表做索引补全还是只想先跑一个随机词条演示掌握这个协议就掌握了整个智能补全的入口。本文用最小代码量带你从零实战打造一个属于你自己的补全提示窗口。智能代码补全从哪里触发先读懂三条主线在动手之前先梳理 CodeEditSourceEditor 代码补全的运行链路它由三个模块协同工作入口层SourceEditor.swift 是 SwiftUI 包装视图构造时传入completionDelegate即可注册你的补全代理。协议层CodeSuggestionDelegate.swift 定义补全数据的获取、筛选与应用约定是本文的主角。展示层SuggestionController.swift 负责提示窗口的弹出、跟随光标与关闭。认识 CodeSuggestionDelegate6 个方法看懂全流程先看协议全貌CodeSuggestionDelegate.swift方法作用是否必选completionTriggerCharacters()返回触发补全的字符集合可选默认空completionSuggestionsRequested(...)异步请求补全建议列表必选completionOnCursorMove(...)光标移动时同步刷新/筛选列表必选completionWindowApplyCompletion(...)用户选中建议后执行插入必选completionWindowDidClose()窗口关闭回调可选completionWindowDidSelect(item:)选中建议未确认回调可选其中最核心的是中间三个方法一个异步拉取一个同步刷新一个落盘执行理解了它们其余都是锦上添花。快速接入三步让补全提示窗口跑起来第 1 步创建补全条目模型提示窗口里每一条建议都遵循 CodeSuggestionEntry.swift 协议。它要求的字段非常直观label主标题、detail副标题、documentation文档说明、sourcePreview源码预览会在窗口里做语法高亮、image与imageColor图标。官方示例 MockCompletionDelegate.swift 里的Suggestion类就是最精简的实现范本。第 2 步实现委托类新建一个类遵循CodeSuggestionDelegate先实现两个必选方法final class MyCompletionDelegate: CodeSuggestionDelegate { // 异步获取建议返回窗口锚点位置 条目数组 func completionSuggestionsRequested( textView: TextViewController, cursorPosition: CursorPosition ) async - (windowPosition: CursorPosition, items: [CodeSuggestionEntry])? { let items await fetchFromYourIndex(cursorPosition: cursorPosition) return (cursorPosition, items) } // 光标移动时的同步刷新只做轻量筛选 func completionOnCursorMove( textView: TextViewController, cursorPosition: CursorPosition ) - [CodeSuggestionEntry]? { return currentItems.filter { $0.label.hasPrefix(currentPrefix) } } // 用户回车确认后把文本真正插入编辑器 func completionWindowApplyCompletion( item: CodeSuggestionEntry, textView: TextViewController, cursorPosition: CursorPosition? ) { textView.textView.insertText(item.label) } }注意completionOnCursorMove必须是同步方法——协议注释明确要求它要快因为每次击键都会调用重活请全部放进异步方法里。第 3 步注册进编辑器在 SwiftUI 中构造 SourceEditor 时传入委托即可或像 TextViewController.swift 那样直接赋值给completionDelegate属性SourceEditor( $text, language: .swift, configuration: config, state: $state, completionDelegate: MyCompletionDelegate() )到这一步你的智能代码补全提示窗口已经能弹出、跟随光标、响应回车了。定制触发时机让补全出现在对的地方默认情况下每输入一个字母或数字都会触发completionSuggestionsRequested见 SuggestionTriggerCharacterModel.swift。如果只想在特定符号后弹出重写completionTriggerCharacters()func completionTriggerCharacters() - SetString { [., (, ] }这样只有输入.、(、时才请求补全可以显著减少无效请求——对走网络请求的 AI 补全尤其重要能帮你省下大量 token 开销。深入提示窗口内部数据如何流动了解数据流能帮你排查问题。看 SuggestionViewModel.swift调用showCompletions后会启动一个异步 Task 请求建议拿到结果后解析光标矩形、定位窗口位置最终交给SuggestionController展示。窗口默认最多显示 8.5 行SuggestionController.swift超出会滚动贴到屏幕边缘时还会自动向上或向下翻转SuggestionControllerWindow.swift这些细节都不需要你操心。一个值得留意的细节窗口内的源码预览会复用 tree-sitter 做快速高亮SuggestionViewModel.swift所以只要给条目填好sourcePreview提示窗口里的代码片段就会自动带上语法颜色观感直接拉满。进阶玩法把 AI 补全接进来掌握了这套机制把 AI 接进来只需两步在completionSuggestionsRequested里请求你的大模型接口把返回内容包装成CodeSuggestionEntry在completionOnCursorMove里做本地前缀过滤保证打字体验不卡顿。异步 同步的职责划分恰好就是为远端取词 本地筛选这种混合场景设计的。小结智能代码补全的核心其实就一句话注册一个CodeSuggestionDelegate实现异步拉取、同步筛选、确认插入三个方法。CodeEditSourceEditor 已经帮你处理好了窗口定位、光标跟随、屏幕边界这些繁琐的 UI 细节你只需要专注补全数据本身。从官方示例 MockCompletionDelegate.swift 出发替换成你自己的词库或 AI 服务一个专业的代码补全提示窗口就诞生了。【免费下载链接】CodeEditSourceEditorA code editor view written in Swift powered by tree-sitter.项目地址: https://gitcode.com/gh_mirrors/co/CodeEditSourceEditor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考