如何设置Sublime Text进行Salesforce Apex代码编写？

本文共计1065个文字，预计阅读时间需要5分钟。

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 类。