AppCode 作为 JetBrains 家族中专门面向 Objective-C 和 Swift 开发的 IDE，凭借强大的代码分析能力和重构功能，一直是不少 iOS 开发者的心头好。不过 AppCode 在 2023 年之后已经停止维护，官方插件生态依然可以通过 JetBrains Marketplace 获取，CodeGeeX 这类 AI 代码补全插件依然能够正常安装使用。CodeGeeX 由智谱团队推出，支持代码补全、注释生成、代码翻译等功能，对 Swift 的支持也比较友好。本文将完整演示在 AppCode 环境下安装和配置 CodeGeeX 的全过程。
一、通过插件市场在线安装 CodeGeeX
在线安装是最简单直接的方式。首先打开 AppCode，进入设置界面。Windows 和 Linux 用户按快捷键 Ctrl + Alt + S，macOS 用户按 Cmd + , 即可打开 Preferences 窗口。在左侧导航栏中找到 Plugins 一项，点击进入插件管理页面。
在插件页面的顶部有一个搜索框，直接输入 CodeGeeX 进行搜索。注意 AppCode 的插件市场默认只显示兼容当前 IDE 的插件，如果搜索不到结果，可以点击搜索框右侧的齿轮图标，选择 Manage Plugin Repositories，确认 JetBrains Marketplace 仓库已经启用。找到 CodeGeeX 插件后点击 Install 按钮，等待下载完成，安装结束后会提示重启 IDE，点击 Restart IDE 让插件生效。
重启之后，如果右侧边栏出现了 CodeGeeX 的图标，说明插件已经安装成功。此时首次使用需要登录账号，点击图标打开工具窗口，按照提示注册或登录即可。登录成功后状态栏会显示当前连接状态，绿色表示可以正常接收补全建议。
二、离线安装方式与适用场景
有些团队的办公网络对插件市场做了限制，或者公司内网无法直接访问 JetBrains Marketplace，这时候可以选择离线安装。先在一台可以上网的电脑上，通过浏览器访问 JetBrains Marketplace 官网，搜索 CodeGeeX 插件页面，在 Versions 标签页中找到与 AppCode 版本兼容的发布版本，点击下载对应版本的 zip 安装包。
拿到 zip 包之后，回到 AppCode 的 Plugins 设置页面，点击齿轮图标，选择 Install Plugin from Disk，在弹出的文件选择框中定位到刚才下载的 zip 包并确认。注意这里不需要解压，直接选择压缩包即可。安装完成后同样需要重启 IDE。
离线安装有一个需要留意的细节：插件版本必须与 AppCode 的构建号兼容。AppCode 较新版本基于 IntelliJ 平台构建，如果下载的插件版本过低，可能会提示不支持当前 IDE，此时在插件页面的版本列表中换一个更新的版本重新下载即可。确认兼容性的方法是查看插件页面 Since build 和 Until build 字段，与 AppCode 关于页面中的 build 号对照。
三、安装后的配置与功能验证
插件装好并不代表可以立刻顺畅使用，还需要做几项基础配置。打开 Preferences，在左侧找到 CodeGeeX 的设置项，这里可以调整补全的触发方式、是否自动显示建议以及隐私相关选项。建议初次使用时保持默认配置，先体验一段时间再按个人习惯调整。
验证补全功能是否正常工作，可以新建一个 Swift 文件，输入一段常见的代码片段观察效果，例如：
import UIKit
class NetworkManager {
static let shared = NetworkManager()
func fetchData(from url: URL, completion: @escaping (Result<Data, Error>) -> Void) {
// 输入到这里时，CodeGeeX 会以灰色幽灵文本的形式给出补全建议
let task = URLSession.shared.dataTask(with: url) { data, response, error in
if let error = error {
completion(.failure(error))
return
}
guard let data = data else {
completion(.failure(NSError(domain: "NoData", code: -1)))
return
}
completion(.success(data))
}
task.resume()
}
}
当灰色补全建议出现时，按 Tab 键即可采纳整段建议。除了行内补全，CodeGeeX 的工具窗口还提供了 Ask CodeGeeX 交互面板，可以选中一段代码后让它解释逻辑、生成注释或者查找潜在问题，这对于阅读遗留的 Objective-C 项目代码非常有用。
Swift 和 Objective-C 混编的项目中，建议在设置里确认两种文件类型的补全都已启用。CodeGeeX 对 Swift 语法结构的理解总体不错，但对于依赖项目上下文的类型推断偶尔会给出不准确的建议，采纳前快速过一遍总是稳妥的做法。
四、常见问题排查与使用建议
安装过程中最常见的几个问题集中在这几类。第一种是搜索不到插件，通常是因为网络原因导致插件市场列表加载失败，可以切换网络或者改用离线安装。第二种是登录后补全一直不出现，先检查右下角状态是否显示已连接，再确认是否在设置中误关闭了自动补全，同时某些文件类型默认不在补全范围内，需要手动添加。
第三种情况是补全延迟明显。AI 补全依赖网络请求到服务端，如果公司网络对出海链路不友好，响应速度会受影响。可以在设置中切换推理模型或者关闭过于频繁的自动触发，改为手动按快捷键请求建议，体验会流畅不少。
最后提醒一点，涉及公司核心业务代码时，注意查看插件的数据处理策略，在设置中可以关闭代码片段上传相关选项，只保留本地上下文补全能力，在效率和安全之间找到平衡点。配置得当的 CodeGeeX 能明显减少样板代码的编写时间，尤其适合网络请求、表单校验这类模式化程度高的场景，值得一试。