Sublime Text不原生支持ChatGPT插件，需通过SublimeAI等第三方插件调用OpenAI API实现类Copilot功能，必须手动配置API密钥（推荐环境变量）、指定有效模型（如gpt-4-turbo）、设置上下文感知prompt、绑定快捷键并启用流式响应，且受限于无上下文记忆与网络稳定性。

Sublime Text 本身不支持 ChatGPT 插件直连，所谓“Sublime ChatGPT 插件”实际是第三方 Python 插件（如 SublimeAI）调用 OpenAI API 实现的类 Copilot 功能，必须手动配置密钥、模型和 prompt，且无官方插件市场分发。

SublimeAI 安装后打不开设置或报错 openai_api_key is missing

这是最常见启动失败原因：插件找不到有效 API 密钥。它不会自动弹窗提示输入，而是静默报错或功能灰掉。

• 不要在插件源码里硬写 sk-... —— 一旦同步配置到 GitHub 或共享电脑，密钥立刻泄露
• 优先用系统环境变量：终端执行 export OPENAI_API_KEY="sk-..."（macOS/Linux）或 setx OPENAI_API_KEY "sk-..."（Windows），然后**从终端启动 Sublime**（subl），否则 GUI 启动方式读不到环境变量
• 若坚持用 Sublime 设置文件，路径必须是 Preferences → Package Settings → SublimeAI → Settings，内容为合法 JSON：

  { "openai_api_key": "sk-...", "model": "gpt-4-turbo" }

  注意末尾不能有多余逗号，引号必须是英文双引号

补全结果乱码、卡住或返回空响应

这不是网络超时就是模型选错或 prompt 不匹配上下文。SublimeAI 默认用 text-davinci-003，但该模型已在 2024 年下线；当前必须显式指定 gpt-3.5-turbo 或 gpt-4-turbo。

Ask Gemini/ChatGPT

用于在用户想通过浏览器自动化与 Google Gemini 或 ChatGPT 交互时。触发短语包括“ask Gemini”“ask ChatGPT”“ask GPT”“让...”。

下载

• 检查 OpenAI Dashboard 中密钥是否启用对应模型权限（gpt-4-turbo 需单独开通）
• 在插件设置中确认 "stream_response": true 已开启——关闭时会等整段响应完成才显示，感知延迟高，容易误判为卡死
• 如果选中一段 Python 代码按快捷键补全，但返回的是 Markdown 格式说明，说明你用的是“解释”prompt 而非“补全”prompt，需检查绑定的命令是否为 sublime_ai_complete 而非 sublime_ai_ask

快捷键无效或触发不了任何响应

SublimeAI 默认不绑定任何快捷键，必须手动配置。它也不监听全局快捷键，只在有文本选中或光标位于可补全位置（如函数体、字符串内）时才生效。

• 打开 Preferences → Key Bindings，添加类似条目：

  [ { "keys": ["ctrl+alt+c"], "command": "sublime_ai_complete", "context": [{ "key": "selection_empty", "operator": "equal", "operand": false }] } ]

  注意 context 限定仅在有选中文本时触发，避免误触
• 确保当前文件语法识别正确（右下角显示 Python 而非 Plain Text），否则插件可能跳过处理
• 部分安全软件或防火墙会拦截 Sublime 的外网请求，可临时禁用测试；Mac 用户还需确认「完全磁盘访问」权限已授予 Sublime Text

真正难的不是配通，而是 prompt 设计和上下文裁剪。Sublime 没有 VS Code 那样的语言服务器上下文感知能力，插件只能拿到当前选中内容 + 文件名 + 语法类型。传太多无关代码进 prompt，既贵又不准；传太少，模型又猜不出意图。每次调用前手动删减注释、日志、无关分支，其实是常态。