4. LSP 选项

LSP 由 :lsp layer 提供(默认启用)。layer 默认值在 coxn.layers.lsp, 超时类默认值在核心 default-options。

4.1 行为开关

选项默认说明
:lsp-autotrue打开有对应服务器的文件时自动 attach(-Dcoxn.lsp.auto=false 可改默认)。M-x lsp 手动 attach
:lsp-auto-installtruePATH 找不到服务器时从官方源(GitHub releases / Eclipse / npm)异步下载到 <config>/lsp/<name>,装好自动重试。M-x lsp-install-server 手动装
:lsp-confirm-editstrueWorkspaceEdit(重命名等)先显示 diff 预览,C-c C-c 才应用
:lsp-on-type-formattingtrue触发字符(如 clangd 的 . ;)之后按服务器要求自动格式化
:lsp-code-action-lighttruepoint 处有诊断且停了 500ms ⇒ mode line 显示 💡(有可用 code action)
:lsp-inlay-hintsfalseinlay hints(类型 / 参数名)。M-x lsp-inlay-hints-mode(M-m m T i)开关

4.2 超时

选项默认说明
:lsp-timeout-ms3000跳定义 / 重命名 / 格式化 / 补全等同步请求的超时
:lsp-eldoc-delay-ms300point 停下多久后问函数提示(nREPL / LSP 共用)
:lsp-sync-wait-ms200用户命令发的请求先同步等这么久,回来了当场出结果,否则转异步(不超过 :lsp-timeout-ms)
:lsp-file-operation-timeout-ms1500改名 / 删文件前问服务器 willRename/willDelete edits 最多等多久(且不超过 :lsp-timeout-ms),超时就当服务器没给编辑、照常动文件

4.3 服务器与服务器设置(无默认值,按需设)

选项说明
:lsp-servers{主模式 [[命令 参数…] …]},与各语言 layer 的内置清单合并(同模式覆盖)。按顺序找第一个装了的命令;参数里的 :workspace-dir 会换成 <cache>/lsp/<命令>/<项目根哈希>(jdtls 需要)。例:(set-option! :lsp-servers {:c++ [["clangd" "--background-index" "--clang-tidy"]]})
:lsp-settings{服务器命令名 设置map},按服务器名深合并到内置默认设置上;发给 initializationOptions.settings、workspace/didChangeConfiguration、workspace/configuration 三处。内置默认给了 jdtls(参数名 inlay hint 等)与 typescript-language-server(inlay hints 常用档)。例:(set-option! :lsp-settings {"jdtls" {:java {:inlayHints {:parameterNames {:enabled "all"}}}}})
:lsp-init-options{主模式 initializationOptions},initialize 时额外带给服务器
:lsp-connect(fn [mode root]) 返回 {:in :out :process} 的替身连接,测试用,一般不设

原始 Markdown:coxn 使用手册(Markdown) · 安装包:coxn 产品页