VS Code中Salesforce Apex文件面包屑与大纲功能失效排查求助

1. 检查Salesforce扩展状态与版本 #

• 打开VS Code扩展面板，搜索Apex，确认「Salesforce Apex」扩展处于激活状态（无禁用标记）。
• 点击扩展卡片的「更新」按钮，确保安装的是最新版本；若更新无效，尝试卸载后重新安装Salesforce Extension Pack及扩展包。

2. 确认项目关联与清理缓存 #

• 检查VS Code左下角是否显示正确的Salesforce组织别名或项目名称，未关联则通过命令面板（Ctrl+Shift+P）执行 SFDX: Open Project，重新打开项目根目录。
• 执行Developer: Reload Window重载窗口；删除项目根目录下的.sfdx文件夹（备份重要配置后操作），重新生成项目元数据缓存。

3. 验证Apex语言服务运行状态 #

• 打开输出面板（Ctrl+Shift+U），在下拉菜单中选择「Apex Language Server」，查看是否有解析错误、连接失败等异常日志，根据日志提示修复问题。
• 检查Docker容器内的Java环境：执行java -version，确认版本为Java 11或17（Salesforce扩展要求的兼容版本），版本不符则安装对应Java版本。

4. 检查VS Code核心设置 #

• 打开设置面板（Ctrl+,）：
  • 搜索breadcrumbs.enabled与outline.enabled，确保两项均处于勾选状态。
  • 搜索salesforcedx-vscode-apex.enableApexLSP，确认值设为true（开启Apex语言服务）。
  • 搜索files.associations，添加或确认配置："*.cls": "apex"，确保.cls文件关联到Apex语言模式。

5. Docker环境特殊检查 #

• 确认容器内项目文件权限正常，VS Code进程拥有读取.cls文件的权限，避免语言服务无法解析文件内容。
• 检查容器网络连接，确保容器可正常访问外部网络，保障扩展能获取语言服务的配置更新。

6. 重置扩展设置（终极方案） #

• 通过命令面板执行Preferences: Reset Settings，选择重置所有设置或仅Salesforce相关设置，之后重新配置项目与扩展。

内容的提问来源于stack exchange，提问作者Øyvind