Clang编译器必须先正确安装并加入PATH，否则Sublime无法调用；需在终端运行clang++ --version和clangd --version验证，两者均应输出版本号，Windows加llvm-mingw的bin路径，macOS注意clang++-14命名，Linux确认clang++指向Clang而非GCC。
Clang 编译器是否已正确安装并暴露在 PATH 中
Sublime Text 本身不提供编译器，所有构建行为都依赖 clang++ 或 clangd 命令能否被系统调用。如果你在终端里执行 clang++ --version 或 clangd --version 报 “command not found”，那 Sublime 的任何配置都会失败——别急着写 .sublime-build 文件，先解决这个前提。
Windows 用户推荐使用 LLVM MinGW（如 llvm-mingw-20231128-ucrt-x86_64），解压后把 bin/ 目录完整路径加进系统 PATH；macOS 用户注意：Homebrew 安装的 clang 默认不覆盖 clang++ 别名，实际可执行文件可能是 clang++-14，需在构建系统中显式写全名；Linux 用户用 sudo apt install clang 即可，但得确认 clang++ 指向的是 Clang 而非 GCC 的符号链接。
- 验证方式：打开全新 CMD/Terminal（不是 Sublime 自带的 console），运行
clang++ --version和clangd --version，两者都应输出版本信息 - 常见坑：MSYS2 或 MinGW-w64 安装后 PATH 没生效，或用户环境变量改了但没重启 Sublime（GUI 启动时可能不继承新 PATH）
- 特别注意：Clang 的调试精度依赖 DWARF 信息，确保你用的是
-g -O0编译参数，而不是默认优化等级
如何写一个支持调试信息生成的 C++.sublime-build
标准的构建系统只管编译，但高精度调试需要完整的调试符号（DWARF）、源码路径映射、以及与 GDB/LLDB 兼容的二进制格式。Clang 默认生成 DWARF v5，而某些旧版调试器可能只支持 v4，这时得加 -gdwarf-4。
以下是一个最小可用且含调试支持的构建配置（保存为 C++ (Clang Debug).sublime-build）：
{
"shell_cmd": "clang++ -std=c++17 -g -gdwarf-4 -O0 -Wall -Wextra "${file}" -o "${file_path}/${file_base_name}"",
"file_regex": "^(.*?):([0-9]+):([0-9]+):? (.*)$",
"working_dir": "${file_path}",
"selector": "source.c++, source.cpp",
"variants": [
{
"name": "Run",
"shell_cmd": ""${file_path}/${file_base_name}""
}
]
}
-
-g是必须的，但仅写它可能生成新版 DWARF，某些调试插件（如 SublimeGDB）会解析失败 → 加-gdwarf-4显式降级 -
-O0关闭优化，否则变量被优化掉、行号错位、内联展开混乱，调试时“跳过”或“看不到值”基本都源于此 -
shell_cmd比cmd数组更可靠，尤其在 Windows 下处理空格路径和中文路径时 - 不要在构建系统里写
pause或cin.get()—— 这是运行时控制，不是调试所需；真要暂停看输出，请用终端手动运行生成的可执行文件
为什么 clangd + LSP 才能实现“高精度”跳转与补全
单纯靠 clang++ 编译无法支撑语义级跳转、重命名、实时诊断。真正提供高精度能力的是 clangd 语言服务器，它需要项目级上下文（即 compile_commands.json），而非单文件编译命令。
如果你只配了构建系统但没配 LSP，那么 Ctrl+Click 跳转会失效、成员函数提示为空、宏定义无法展开——这不是 Sublime 问题，是缺少语义索引。
- 生成
compile_commands.json最简单方式：bear --make（需先make配置好 Makefile）或 CMake 用-DCMAKE_EXPORT_COMPILE_COMMANDS=ON -
clangd必须指向你安装的版本，例如 Windows 下路径可能是C:\llvm-mingw-20231128-ucrt-x86_64\bin\clangd.exe，不能只写clangd - LSP 设置里务必开启
"enabled": true和"settings": {"clangd.arguments": ["--header-insertion-decorators"]}，否则头文件包含补全不灵敏 - 项目根目录下必须存在
compile_commands.json，且不能放在子目录；LSP 不会自动向上查找，也不会读取 .sublime-project 里的路径配置
调试时看不到变量值或断点不命中？检查这三处
Clang 编译出的二进制理论上比 GCC 更易调试，但实际遇到“断点灰掉”“variables 空白”“step over 直接跳函数末尾”，往往不是工具链问题，而是构建与调试上下文脱节。
- 确认你用的是同一套 Clang 工具链：构建系统调用
clang++，clangd和调试器（如 SublimeGDB）调用的lldb或gdb必须来自同一个发行版（比如都是 llvm-mingw 提供的，而不是混用 MinGW-w64 的 gdb） - 检查源文件编码：UTF-8 with BOM 会导致 Clang 解析错行号，.sublime-build 里别写
"encoding": "cp936"，统一用 UTF-8（无需声明，默认就是） - Sublime 自带的 Build 输出面板不支持交互式调试输入（比如
std::cin），想调试带输入的程序，必须用外部终端运行，或配合 SublimeREPL（已停止维护）等插件——这不是 Clang 的限制，是 Sublime 构建系统的固有设计
Clang 的调试精度本身没问题，问题常出在构建、索引、调试三者用的不是同一份源码视图或符号表。每一步都要验证命令是否真的执行了，而不是“看起来配好了”。
