lsp-clang

lsp 作用

简单来说，clangd 就像一个精通 C++ 的超级助手，它实时地分析你的代码，然后把分析结果通过 LSP（语言服务器协议）告诉 Neovim。Neovim 再根据这些信息，为你提供一系列强大的 IDE 功能。

clangd 的核心作用就是：让 Neovim “理解” C++ 代码。

下面是它具体能为你做的事情，以及如何使用你在上一份配置中设置的快捷键来体验它们：

1. 智能代码补全 (Intelligent Code Completion)

这是最直观的功能。当你输入代码时，clangd 会根据上下文提供精确的补全建议。

• 有什么用？

  • 减少输入：不用再手动敲写完整的函数名、变量名。
  • 避免拼写错误：从补全列表中选择可以确保名称正确无误。
  • API 探索：当你输入一个对象和 . 或 -> 后，clangd 会列出所有可用的成员函数和变量，帮助你快速了解一个类的功能，而无需去查阅文档。

• 如何体验？

  • 需要配合一个补全插件，比如 nvim-cmp。
  • 当你输入代码时，补全窗口会自动弹出。例如，输入 std::vector<int> v; v. 就会看到 push_back, size, begin 等成员函数。

2. 实时诊断：错误和警告 (Real-time Diagnostics)

clangd 会在你编写代码的同时进行静态分析，实时地标记出语法错误、类型不匹配、潜在的 bug 和不符合规范的代码。

• 有什么用？

  • 快速反馈循环：你不需要等到编译代码时才发现一个简单的语法错误。错误会立即在你的编辑器中高亮出来，大大缩短了“编码-编译-调试”的周期。
  • 提升代码质量：它不仅能发现编译错误，还能通过 clang-tidy 给出代码风格建议和潜在风险警告。

• 如何体验？

  • 代码中的错误或警告下方会出现波浪线。
  • 行号列会显示图标（例如  表示错误， 表示警告）。
  • 将光标移动到有问题的代码上，使用快捷键 <leader>e 可以浮窗显示详细的诊断信息。
  • 使用 [d 和 ]d 可以在文件中的多个诊断点之间快速跳转。

3. 代码导航 (Code Navigation)

在大型项目中，能够快速地在代码库中跳转是至关重要的。

• 有什么用？

  • 快速理解代码：想知道一个函数是做什么的？直接跳转到它的定义处查看源码。
  • 理清调用关系：想知道一个函数被哪些地方调用了？一键列出所有引用。

• 如何体验？

  • 将光标放在一个函数或变量上：
    • 按 gd (Go to Definition) 会跳转到它的定义位置。
    • 按 gi (Go to Implementation) 会跳转到它的具体实现位置（对虚函数特别有用）。
    • 按 gr (Go to References) 会列出项目中所有引用了该符号的地方。

4. 代码信息悬浮提示 (Hover Information)

当你不确定一个函数或变量的类型、签名或文档时，可以快速查看。

• 有什么用？

  • 无需离开编辑器：不用切换到浏览器或头文件去查找函数原型或注释。
  • 快速确认：快速查看变量的推导类型 (auto)，或者函数的参数和返回值。

• 如何体验？

  • 将光标悬停在一个函数、变量或类型上，然后按 K。一个浮动窗口会显示它的详细信息，包括 Doxygen 风格的注释。

5. 代码重构与代码动作 (Refactoring & Code Actions)

clangd 可以安全、自动地帮你修改代码。

• 有什么用？

  • 安全重命名：当你需要修改一个函数或变量的名字时，手动修改非常危险，容易遗漏。重构功能可以一次性、安全地修改项目中所有引用的地方。
  • 自动修复和优化：clangd 会提供一些“代码动作”，比如自动添加缺失的 #include，将实现代码提取到源文件，或者根据 clang-tidy 的建议自动修复代码。

• 如何体验？

  • 将光标放在要重命名的符号上，按 <F2>，输入新名字后回车，所有相关的地方都会被修改。
  • 将光标放在有警告或特定代码块上，按 <leader>ca (Code Action) 会弹出一个菜单，让你选择可以执行的操作。

总结

拥有 clangd 之前，Neovim 是一个带语法高亮的文本编辑器。 拥有 clangd 之后，Neovim 变成了一个为 C++ 量身定制的、理解代码逻辑的智能开发环境 (IDE)。

它帮你写得更快（代码补全）、看得更清（代码导航和悬浮提示）、改得更准（重构）、错得更少（实时诊断）。尤其是在处理不熟悉或者庞大的代码库时，这些功能带来的效率提升是革命性的。