如何用 CodeGraphContext 追蹤調(diào)用鏈callers、callees、chain 三大分析場景實(shí)戰(zhàn)【免費(fèi)下載鏈接】CodeGraphContextAn MCP server plus a CLI tool that indexes local code into a graph database to provide context to AI assistants.項(xiàng)目地址: https://gitcode.com/gh_mirrors/co/CodeGraphContextCodeGraphContextCGC是一個(gè) MCP 服務(wù)器加 CLI 工具它把本地代碼索引進(jìn)圖數(shù)據(jù)庫為 AI 助手和開發(fā)者提供代碼上下文。其中最實(shí)用的能力就是代碼調(diào)用鏈追蹤一條命令就能回答誰調(diào)用了我、我調(diào)用了誰以及從 A 到 B 的調(diào)用路徑是什么。本文帶你用callers、callees、chain 三大分析場景快速上手 CodeGraphContext 調(diào)用鏈分析。先看懂CodeGraphContext 調(diào)用鏈分析的原理CGC 用 Tree-sitter 解析 22 種語言的源碼把函數(shù)、類、模塊變成圖節(jié)點(diǎn)把調(diào)用、包含、繼承變成有向邊存入圖數(shù)據(jù)庫。之后所有查詢都是毫秒級的圖遍歷而不是全文搜索源碼。三大場景對應(yīng)的入口場景CLI 命令MCP 工具query_type一句話含義① 找調(diào)用者cgc analyze callers 函數(shù)find_callers誰調(diào)用了這個(gè)函數(shù)② 找被調(diào)用者cgc analyze calls 函數(shù)find_callees這個(gè)函數(shù)調(diào)用了誰③ 找調(diào)用鏈cgc analyze chain 起點(diǎn) 終點(diǎn)call_chain兩個(gè)函數(shù)之間怎么走快速上手3 步建好你的調(diào)用鏈圖譜第 1 步索引項(xiàng)目cd /path/to/your/repository cgc indexCGC 會尊重.gitignore/.cgcignore增量索引重復(fù)執(zhí)行很快。第 2 步驗(yàn)證圖譜cgc stats確認(rèn)函數(shù)、類、模塊節(jié)點(diǎn)和 CALLS 關(guān)系邊的數(shù)量已寫入數(shù)據(jù)庫。第 3 步隨時(shí)刷新cgc watch開啟文件監(jiān)視器后每次保存代碼都會增量更新圖譜調(diào)用鏈分析永遠(yuǎn)是最新狀態(tài)。場景一callers —— 誰調(diào)用了這個(gè)函數(shù)當(dāng)你接手一個(gè)祖?zhèn)骱瘮?shù)想重構(gòu)它時(shí)第一件事就是搞清楚調(diào)用者改簽名會不會炸cgc analyze callers process_data結(jié)果以表格展示調(diào)用者函數(shù)名、所在文件與行號、以及它是項(xiàng)目代碼還是第三方依賴。同名函數(shù)沖突時(shí)用--file指定定義文件即可精準(zhǔn)定位cgc analyze callers process_data --file src/main.py如果你是通過 AI 助手提問效果就像下圖這樣——直接讓 AI 調(diào)用analyse_code_relationships工具回答誰調(diào)用了 add_file_to_graph 實(shí)戰(zhàn)建議重構(gòu)前先跑一次callers再跑一次find_all_callers深度搜索確認(rèn)沒有任何隱藏入口才動手。場景二callees —— 這個(gè)函數(shù)調(diào)用了誰排查 bug 時(shí)你往往站在入口函數(shù)上需要看清它往下扇出的執(zhí)行路徑。CodeGraphContext 的 callees 分析就是干這個(gè)的cgc analyze calls process_data輸出表格列出每個(gè)被調(diào)用函數(shù)、位置、類型 項(xiàng)目內(nèi) / 依賴庫幫你快速判斷這段邏輯到底觸發(fā)了哪些下游。 技巧給任何analyze/find命令加上--visual或-V結(jié)果會直接打開交互式圖譜界面肉眼比看表格更直觀cgc analyze calls process_data --visual場景三chain —— 兩個(gè)函數(shù)之間的調(diào)用路徑這是調(diào)用鏈追蹤的王牌請求從main進(jìn)來最終落到了process_data中間的調(diào)用鏈長什么樣cgc analyze chain main process_dataCGC 會做最短路搜索默認(rèn)深度 5把整條路徑按層級縮進(jìn)打印出來每一跳還附帶調(diào)用發(fā)生的行號和實(shí)參cgc analyze chain main process_data --depth 10 cgc analyze chain main process --from-file main.py --to-file utils.py同名函數(shù)分不清起點(diǎn)或終點(diǎn)時(shí)--from-file/--to-file可以指定文件消除歧義。找到路徑后加--visual整條調(diào)用鏈會以圖的形式呈現(xiàn) 典型應(yīng)用回歸影響分析。線上故障定位到某個(gè)深層函數(shù)后用chain反向找到所有能到達(dá)它的入口HTTP 路由、CLI 命令、定時(shí)任務(wù)一下子就知道哪些功能受影響。讓 AI 替你分析MCP 工具 analyze_code_relationships把 CGC 接入 IDE 的 AI 助手Cursor、Claude 等后你甚至不用記命令。MCP 服務(wù)器注冊的analyze_code_relationships工具支持上表全部三種場景AI 會自動選擇query_typefind_callers/find_callees/call_chain等 15 種遍歷類型并解讀結(jié)果對 AI 助手而言這意味著它看懂代碼不再靠猜而是靠圖數(shù)據(jù)庫里真實(shí)的調(diào)用邊——回答這兩個(gè)函數(shù)有什么關(guān)系時(shí)給出的每一條鏈路都是可驗(yàn)證的。三大場景速查表需求CLI 命令MCPquery_type常用參數(shù)直接調(diào)用者cgc analyze callers fnfind_callers--file消歧、--visual直接被調(diào)用者cgc analyze calls fnfind_callees--file、--visual全量上游/下游—find_all_callers/find_all_calleesdepth默認(rèn) 3兩點(diǎn)間調(diào)用鏈cgc analyze chain a bcall_chain--depth默認(rèn) 5、--from-file、--to-file常見問題排查提示 No callers found先確認(rèn)已執(zhí)行cgc index并且該函數(shù)確實(shí)被解析過可用cgc stats或cgc find name 函數(shù)驗(yàn)證。結(jié)果太多被截?cái)嘟Y(jié)果默認(rèn)有行數(shù)上限保護(hù)輸出末尾會提示總數(shù)縮小范圍可加repo_path/--context限定倉庫或上下文。深度不夠找不到鏈chain默認(rèn)只搜 5 層跨層調(diào)用多的項(xiàng)目請用--depth 10。延伸閱讀完整 CLI 參考docs/docs/reference/cli.mdMCP 工具參考docs/docs/reference/mcp.md快速上手指南docs/docs/getting-started/quickstart.md索引與查詢原理docs/docs/concepts/how-it-works.md調(diào)用鏈查詢核心實(shí)現(xiàn)src/codegraphcontext/tools/code_finder.pyanalyze chain命令源碼src/codegraphcontext/cli/main.py【免費(fèi)下載鏈接】CodeGraphContextAn MCP server plus a CLI tool that indexes local code into a graph database to provide context to AI assistants.項(xiàng)目地址: https://gitcode.com/gh_mirrors/co/CodeGraphContext創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考