Delphi 11 Alexandria LSP代码补全无法识别新增单元解决方案咨询

该问题是Delphi 11替换原有原生Code Insight引擎、改用LSP架构后，大项目场景下的典型缓存同步故障，10.3版本使用旧引擎不存在这类架构层面的同步问题，可按以下优先级尝试解决，无需每次重启IDE：

• 快速恢复补全的临时方案
  • 右键点击代码编辑区空白处，选择「Refresh Code Insight」选项，触发LSP重新扫描当前打开的单元和项目引用，多数新增uses、新增单元后的识别失效问题可以在数秒内恢复。
  • 如果刷新操作无效，直接打开系统任务管理器，结束DelphiLSP.exe进程，IDE会自动重启LSP服务并重新加载全项目符号表，整个过程耗时通常在10秒以内，远快于重启整个IDE。
• 调整LSP配置减少故障触发
  打开「Tools -> Options -> User Interface -> Editor -> Language -> Code Insight」设置页，做如下调整：
  • 将LSP服务内存上限从默认的1024MB调高，16G内存的开发机建议设置为4096MB，32G及以上内存建议设置为8192MB。300单元规模的项目触发补全失效，很大概率是默认内存不足导致LSP主动丢弃了新增单元的符号缓存。
  • 取消勾选「Load inactive project paths in LSP scan」，避免LSP扫描无关的历史路径、第三方组件冗余路径占用解析资源，拖慢增量解析速度。
  • 将后台解析优先级调整为「High」，避免IDE的UI操作、窗体设计操作打断LSP的增量解析流程，导致新增的函数、引用没被录入符号表。
• 日常开发的规避操作
  • 新增单元引用、新增完全局函数/过程后，先按Ctrl+F9触发一次项目增量编译，编译过程生成的符号表会直接同步给LSP服务，比等待LSP自动解析的识别成功率高很多。
  • 大项目下不要在写完uses条目后立刻输入相关代码，预留1-2秒等待LSP完成增量解析，减少补全不触发的概率。
• 版本兜底方案
  • 升级Delphi 11到Update 2及以上的官方更新版本，初始发布版、Update 1版本存在至少7处大项目下LSP增量解析失效、新增单元不录入符号缓存的已知bug，后续补丁已经做了针对性修复。
  • 如果调整配置后故障仍然频繁出现，可以在Code Insight设置页取消勾选「Use LSP for Code Completion」，切回和10.3版本逻辑一致的传统Code Insight引擎，不存在缓存同步问题，仅对部分Delphi新语法的补全精度略低于LSP引擎。

注意：不要在项目加载过程中快速新增单元、修改uses列表，此时LSP还没完成全项目符号表的初始化，增量解析的队列很容易阻塞，直接导致后续新增内容无法被识别。

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