如何配置Clangd/LSP-Mode，实现C项目跳转至外部库函数定义？

我使用Emacs的lsp-mode搭配Clangd开发一个静态链接外部库的C项目，库源码位于系统其他目录。单独将library或project作为LSP根目录时，两者LSP功能均正常，但在项目源码中调用库函数时，LSP查找定义只能跳转至库的头文件，无法定位到库源码中的函数实现。

文件系统核心结构如下：

.
└── /
    └── code/
        ├── library/
        │   ├── .clangd
        │   └── src/
        │       ├── c/
        │       │   └── libsource.c
        │       ├── include/
        │       │   └── libsource.h
        │       └── lib/
        │           └── libbinary.lib
        └── project/
            ├── .clangd
            ├── src/
            │   ├── c/
            │   │   └── projectsource.c
            │   └── include/
            │       └── projectsource.h
            └── env/
                └── compile_commands.json

两个项目的.clangd文件仅配置各自compile_commands.json的路径。项目的compile_commands.json包含指向库头文件的-I../../library/source/include编译选项，但运行在project目录下的Clangd仅识别库头文件，无法感知库的源码文件。尝试将code目录作为LSP根目录，问题仍未解决。

解决方案 #

1. 在Project的.clangd中引入Library的编译数据库 #

修改project/.clangd文件，添加Library的compile_commands.json路径，让Clangd同时索引两个项目的编译信息：

# project/.clangd 内容
CompileCommands: ./env/compile_commands.json
# 添加Library的编译数据库路径
CompileCommands: ../library/env/compile_commands.json

Clangd会自动合并多个CompileCommands配置的编译单元信息，关联库的源码实现与头文件。

2. 配置Emacs LSP-Mode为多根工作区 #

在Emacs中，将library目录添加到当前工作区的文件夹列表，让lsp-mode通知Clangd同时处理两个项目：

# 打开project后执行，或添加到配置文件
(lsp-add-workspace-folder "/path/to/code/library")
# 重启LSP服务生效
(lsp-restart-workspace)

也可以通过M-x lsp-workspace-folders-add手动选择library目录，Clangd会自动索引该目录下的编译信息。

3. 调整Project的compile_commands.json，包含Library源码路径 #

如果Library没有独立的compile_commands.json，可以在Project的编译数据库中，为每个编译单元添加Library源码的包含路径，让Clangd扫描到库的.c文件：

// project/env/compile_commands.json 中编译单元示例
{
  "directory": "/path/to/code/project",
  "command": "gcc -c src/c/projectsource.c -I../../library/src/include -I../../library/src/c",
  "file": "src/c/projectsource.c"
}

添加-I../../library/src/c确保Clangd能定位到库的源码文件。

4. 指定Clangd的项目根目录并强制索引Library #

修改Project的.clangd，将项目根目录设为上级code目录，并明确指定要索引的路径：

# project/.clangd 内容
ProjectRoot: ../
CompileCommands: ./env/compile_commands.json
# 强制Clangd索引Library目录
Index:
  External:
    Paths:
      - ../library/src

这样Clangd会以code为根目录，同时索引project和library的源码，关联头文件与实现。

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