sublime text 3 本身不支持 apex 开发，必须通过 haoide 插件接入 salesforce tooling api 才能实现代码编辑、上传、执行等核心功能；直接编辑 .cls 文件仅为纯文本，无语法校验、保存即部署或调试能力。
Sublime Text 3 本身不支持 Apex 开发，必须通过 HaoIDE 插件接入 Salesforce Tooling API 才能实现代码编辑、上传、执行等核心功能。直接装 Sublime 后写 .cls 文件只是纯文本，没有语法校验、保存即部署、调试日志等能力。
安装 HaoIDE 插件失败的常见原因和绕过方法
HaoIDE 已于 2021 年底停止维护，当前（2026 年）在 Sublime Text 3 / 4 上安装常因依赖过期或证书问题失败，典型现象是 Package Control 显示 Package Control: Error downloading package. 或安装后无 HaoIDE 菜单项。
- 不要依赖在线仓库自动安装 —— 直接下载最新可用 release（如
v3.1.5）的HaoIDE.sublime-package文件，手动放入Installed Packages/目录（可通过Preferences → Browse Packages…进入上级目录定位） - 若提示 SSL 错误，需关闭 Sublime 的证书验证：在
Preferences → Settings – User中添加"http_timeout": 30, "https_verify_ssl": false - 安装后重启 Sublime，检查菜单栏是否出现
HaoIDE；若仍不显示，说明插件未加载，可打开Console（Ctrl + `）查看 Python import 报错，大概率是requests或pyopenssl缺失 —— 此时建议放弃，改用 VS Code + Salesforce Extension Pack
toolingapi.sublime-settings 必须填对的字段
该文件位于 Preferences → Package Settings → HaoIDE → Settings – User，不是普通 Sublime 设置。错误配置会导致登录失败、项目为空、无法下载元数据。
-
"login_url"必须严格匹配环境："https://login.salesforce.com"（生产）或"https://test.salesforce.com"（沙盒），多一个斜杠或少一个字母都会返回INVALID_LOGIN -
"username"和"password"是基础认证，但若 org 启用了 IP 白名单以外的登录限制，"security_token"字段不可为空，且必须是最新重置的 token（路径：Setup → Personal Settings → Reset My Security Token） -
"workspace"必须是**绝对路径**，Windows 下要写成"C:\Users\name\sf-projects"（双反斜杠）或"C:/Users/name/sf-projects"（正斜杠），相对路径会静默失败 -
"subscribed_metadata_objects"决定你右键HaoIDE → Retrieve能拉哪些内容，Apex 开发至少保留"ApexClass"、"ApexTrigger"、"ApexPage"、"ApexComponent"；漏掉"ApexTrigger"就看不到触发器文件
保存即部署（Save to Server）失败的三个硬性条件
右键 → HaoIDE → Save to Server 不起作用，通常不是网络问题，而是以下任一条件未满足：
- 当前文件必须已归属某个 HaoIDE 项目 —— 即文件路径需在
"workspace"指定目录下，且文件名符合命名规范（如MyClass.cls），否则插件识别为“非 SF 文件”而禁用菜单项 - 必须先完成一次完整
Retrieve（右键项目根目录 →HaoIDE → Retrieve），否则本地无 metadata 描述，插件不知道该往哪个 org 的哪个组件类型里传 - 文件内容首行不能有 BOM（字节顺序标记），尤其 Windows 记事本另存为 UTF-8 时默认加 BOM，会导致
INVALID_TYPE错误；建议用 Sublime 自身“Save with Encoding → UTF-8”重存
现在 HaoIDE 的实际可用性已严重受限：Salesforce 在 2024 年起逐步停用旧版 Tooling API 的部分端点，而 HaoIDE 无法更新适配；更关键的是，它完全不支持 LWC、Aura Bundle 的结构化上传与依赖解析。如果你正在新建项目或团队协作，sfdx force:source:push + VS Code 是唯一稳定路径 —— Sublime + HaoIDE 只适合阅读旧脚本或临时调试单个 Apex 类。
