vscode clangd ubuntu

### 配置 Ubuntu 上的 VSCode 使用 clangd 进行 C/C++ 开发 #### 1. 安装必要的工具和依赖项 为了在 Ubuntu 上使用 VSCode 和 clangd，需要安装一些基础工具和库。这些工具包括 `clang`、`llvm` 工具链以及其他支持组件。 ```bash sudo apt update sudo apt install -y clang llvm libclang-dev build-essential cmake ``` 上述命令会安装 Clang 编译器及其相关工具链，以及构建所需的其他软件包[^1]。 --- #### 2. 安装 Visual Studio Code 及其扩展 下载并安装最新版本的 Visual Studio Code (VSCode)，可以通过以下方式完成： ```bash wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/ sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list' rm -f packages.microsoft.gpg sudo apt update sudo apt install code ``` 接着，在 VSCode 中安装以下两个核心扩展： - **C/C++ 插件**：提供语法高亮、调试等功能。 - **Clangd 扩展**：启用基于 LLVM 的语言服务器协议支持。 通过 Extensions Marketplace 搜索并安装这两个插件[^2]。 --- #### 3. 设置 Clangd Server Clangd 是一种基于 LSP（Language Server Protocol）的语言服务程序，它能够为用户提供代码补全、跳转定义、错误检测等功能。以下是具体配置方法： ##### a. 创建测试项目结构 创建一个简单的 C/C++ 测试项目来验证配置是否成功。假设项目的根目录名为 `my_project`，可以按照如下布局组织文件夹： ``` my_project/ ├── src/ │ └── main.cpp └── compile_commands.json ``` 其中，`main.cpp` 文件的内容如下所示： ```cpp #include <iostream> int main() { std::cout << "Hello, World!" << std::endl; return 0; } ``` ##### b. 生成编译数据库 (`compile_commands.json`) Clangd 需要读取 `compile_commands.json` 来了解源码是如何被编译的。如果未指定该文件，则无法正确解析头文件路径或其他编译选项。 对于简单项目，可以直接手动编写此 JSON 文件；而对于复杂工程，推荐利用工具自动生成。例如，借助 `bear` 或者 `intercept-build` 命令记录实际编译过程中的参数。 运行以下指令以生成 `compile_commands.json`: ```bash sudo apt-get install bear bear make ``` 或者直接写入静态样例数据到 `compile_commands.json` 如下： ```json [ { "directory": "/path/to/my_project", "command": "cc -I/usr/include/c++/9 -std=c++17 -o src/main.o -c src/main.cpp", "file": "src/main.cpp" } ] ``` 注意替换 `/path/to/my_project` 为你的真实工作区位置。 --- #### 4. 启动 VSCode 并加载项目 打开终端进入项目所在路径后启动 VSCode： ```bash cd my_project code . ``` 此时应该可以看到左侧资源管理器显示当前文件列表。确保已激活之前提到过的 Clangd 扩展，并等待初始化完成后即可享受智能化编码体验[^3]。 --- #### 5. 调试功能集成 除了基本的代码分析外，还可以进一步完善调试流程。比如添加断点、单步执行等操作都需要额外配置 launch settings 文件(`launch.json`)。下面给出一段典型模板供参考： ```json { "version": "0.2.0", "configurations": [ { "name": "(gdb) Launch", "type": "cppdbg", "request": "launch", "program": "${workspaceFolder}/demo", // 替换为目标二进制名称 "args": [], "stopAtEntry": false, "cwd": "${workspaceFolder}", "environment": [], "externalConsole": true, "MIMode": "gdb", "setupCommands": [ { "description": "Enable pretty-printing for gdb", "text": "-enable-pretty-printing", "ignoreFailures": true } ], "preLaunchTask": "build" }, { "name": "Build Task", "type": "shell", "label": "build", "command": "make", "group": { "kind": "build", "isDefault": true } } ] } ``` 保存至 `.vscode/launch.json` 即可生效。 ---