sublime text 不原生支持 apex 开发，haoide 是唯一可用插件但已于 2026 年停止维护；配置失败主因是 python 环境不兼容及 toolingapi.sublime-settings 字段错误，建议改用 vs code。
Sublime Text 本身不支持 Apex 开发，装完就是个高级记事本；HaoIDE 是唯一还能凑合用的插件，但它在 2026 年已停止维护，配置失败是常态，不是意外。
安装 HaoIDE 失败时别试 Package Control 在线安装
Package Control 显示 Package Control: Error downloading package 或安装后菜单栏没 HaoIDE 项，基本等于白忙。这不是你网络问题，而是插件依赖的 requests、pyopenssl 等底层库与当前 Sublime（尤其是 ST4）Python 环境不兼容。
- 直接去 GitHub 找
HaoIDE最后一个可用 release（如v3.1.5），下载HaoIDE.sublime-package文件 - 通过
Preferences → Browse Packages…进入上级目录，手工把文件丢进Installed Packages/文件夹 - 若仍报 SSL 错误，必须在
Preferences → Settings – User中加两行："https_verify_ssl": false和"http_timeout": 30 - 重启 Sublime 后按
Ctrl + `调出 Console，看有没有ImportError—— 有就说明 Python 模块缺失，此时建议立刻停手，换 VS Code
toolingapi.sublime-settings 必填字段不能拼错
这个文件不在 Sublime 主设置里，而是在 Preferences → Package Settings → HaoIDE → Settings – User。写错任意一个字段，都会静默失败，现象是：登录成功但项目为空、右键没 Retrieve、保存不上传、报 INVALID_LOGIN 或 invalid session id。
-
login_url必须是完整 URL："https://login.salesforce.com"（生产）或"https://test.salesforce.com"（沙盒），多一个/或少一个字母都不行 -
password字段要填「密码 + security_token」拼接后的字符串，不是单独密码；token 必须从 Setup → Personal Settings → Reset My Security Token 重置获取 -
workspace必须是绝对路径：Windows 写成"C:/Users/name/sf-projects"（推荐正斜杠）或"C:\Users\name\sf-projects"（双反斜杠），写"./projects"会完全没反应 -
subscribed_metadata_objects至少包含"ApexClass"、"ApexTrigger"、"ApexPage"、"ApexComponent"，漏掉任一，右键HaoIDE → Retrieve就拉不到对应文件
上传代码失败常见于 session 过期或权限不足
右键代码 → HaoIDE → Save to Server 卡住、无提示、或弹出模糊错误，大概率不是网络问题，而是 session 已失效或 org 限制了 API 访问。
- 检查 org 是否启用了 IP 白名单：如果只允许特定 IP 登录，又没配 token，
Save to Server必然失败 - 确认用户 Profile 有 “API Enabled” 权限，且没有被组织级 API 流量限制拦截
- 执行一次
HaoIDE → Switch Project，再点两下，强制刷新 session；若仍失败，在 Console 里看是否有Session expired或INSUFFICIENT_ACCESS - 不要依赖“保存即部署”：HaoIDE 的自动保存上传不稳定，建议养成习惯——改完先
Ctrl+S本地保存，再右键手动触发Save to Server
真正卡住的地方从来不是怎么装插件，而是 toolingapi.sublime-settings 里一个斜杠、一个空格、一个拼写错误，就会让整个流程静默中断。2026 年还在用 Sublime 做 Apex 开发，本质上是在和过期的工具链博弈，每一步都要盯着 Console 输出和 Salesforce 日志交叉验证。
