Vim YouCompleteMe 設定指南：讓自訂標頭檔函式與型別也能自動補全

常見問題

已在 .ycm_extra_conf.py 的 flags 中加入 -I 指定專案標頭檔路徑，基本關鍵字能補全，但專案自訂的類別、函式卻無提示。

核心檢查清單

1. 編譯資料庫（compile_commands.json）：YCM 最佳運作模式需專案根目錄存在 compile_commands.json（由 CMake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON 或 Bear 生成）。此檔案記錄每個原始檔的完整編譯參數，包含所有 include 路徑、巨集定義、C++ 標準版本等。
2. .ycm_extra_conf.py 回傳正確 flags：若無法生成 compile_commands.json，需確保 FlagsForFile 回傳的 flags 完整涵蓋專案所有 -I、-D、-std=c++17 等參數。可參考 YCM 官方範例模板。
3. 標頭檔關聯性：YCM 透過分析 #include 關係推導補全。確認標頭檔有被對應的 .cpp 包含，且該 .cpp 出現在編譯資料庫中。
4. 專案根目錄識別：YCM 會向上尋找 .git、.hg、compile_commands.json 等標記判斷專案根目錄。若專案結構特殊，可在 .ycm_extra_conf.py 中實作 ProjectDirectory 方法。

快速驗證步驟

1. 在 Vim 中開啟任一專案 .cpp，輸入 :YcmDebugInfo 查看偵測到的編譯旗標與 include 路徑。
2. 若旗標缺失，檢查 compile_commands.json 或 .ycm_extra_conf.py 邏輯。
3. 輸入 :YcmCompleter GoToDefinition 測試能否跳轉至自訂函式定義。

常見誤區

• 僅在 flags 加 -I/path/to/include 但缺少 -std=c++14 等導致解析失敗。
• 標頭檔未被任何編譯單元包含，YCM 視為孤立檔案不建立索引。
• 使用系統級 .ycm_extra_conf.py 卻未載入專案專屬設定。

建立完整的編譯資料庫，是 YCM 精準補全自訂程式碼的基石。投入時間配置一次，長期受惠無窮。