設定

零設定預設

CodeGraph 開箱即零設定：語言支援依副檔名自動，沒什麼要逐語言接線。唯一的選擇性檔是 codegraph.json，放在專案根目錄。

開箱即跳過：

• 依賴、build、cache 目錄——node_modules、vendor、dist、build、target、.venv、Pods、.next…（即使沒有 .gitignore 也成立）——圖是你的程式，不是第三方噪音。
• 任何 .gitignore 的東西——git repo 透過 git 讀取；非 git 專案直接讀 .gitignore（根與巢狀）。
• 超過 1 MB 的檔——generated bundle、minified JS、vendored blob。

排除 / 納入

想把東西排除：加進 .gitignore。想把預設排除的目錄拉回來（例如你真的想索引 vendored 依賴）：加否定式 !vendor/。

但 .gitignore 無法丟掉你已 commit 的目錄。對已 commit 的 vendored theme / SDK（例如 Metronic theme 在 static/），在 codegraph.json 的 exclude 下列出（gitignore 風格 pattern，對 repo-root-relative 路徑比對，index/sync/watch 都適用）：

{
  "exclude": ["static/", "**/vendor/**"]
}

反過來，當真原始碼被刻意 gitignore（專案同時用第二套 VCS——SVN、Perforce——把自己原始碼 gitignore 掉），用 include 強制拉回（include 是 exclude 的反面；includeIgnored 只救回 embedded git repos，不是普通原始碼）：

{
  "include": ["Tools/", "Local/typescript/"]
}

CodeGraph 在 index/sync/watch 時從磁碟發現這些檔、覆寫 .gitignore。顯式 exclude 仍優先；內建跳過（node_modules、dist、.git）永不重開。

自訂副檔名

專案用非標準副檔名對應受支援語言時（例如 .dota_lua 是 Lua、.tpl 是 PHP），用 extensions 對映：

{
  "extensions": {
    ".dota_lua": "lua",
    ".tpl": "php"
  }
}

每個值是受支援的語言 id。對映會疊在內建預設之上、衝突時取勝，所以也能改指內建（例如 ".h": "cpp"）。commit 這個檔與團隊共享。打錯語言或格式壞掉的檔只會警告並跳過，不會中斷索引；改完對映要 codegraph index 重跑。

相關環境變數（速查）