gograph

概述

gograph是一个快速的、仅限本地的CLI工具，专门用于生成Go代码库的仓库结构并提高IDE上下文感知能力。它构建了一个包含包、符号、调用、路由、配置读取、测试和代码质量信号的紧凑图谱，使AI代理能够通过更少的原始文件读取来导航Go代码库。与为人类IDE优化的语言服务器（如gopls）不同，gograph专门为基于终端的LLM设计，通过以原生Markdown格式提取精确的结构切片来节省上下文标记。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• boundaries

  Verify package architecture constraints using boundaries.json

  试试:Check for architecture boundary violations试试:Enforce package import rules
• callers

  See what functions call a specific symbol

  试试:Find all functions that call ValidateToken试试:Who calls this method?
• callees

  See what a specific function calls

  试试:Show what InitServer calls试试:List all function calls in this method
• complexity

  Calculate cyclomatic complexity for functions

  试试:Show complexity of the Run function试试:List most complex functions in the codebase
• focus

  Generate highly targeted context for a specific package

  试试:Get focused context for internal/auth package试试:Show me only the service layer code
• hotspot

  Rank functions by incoming call count

  试试:Show top 10 most called functions试试:Find the busiest methods in the codebase
• impact

  View the full blast radius of a symbol

  试试:Show impact of ValidateToken changes试试:What depends on this function?
• interfaces

  See which interfaces a struct satisfies

  试试:Show interfaces implemented by UserService试试:Which structs satisfy this interface?
• path

  Find the shortest call chain between two symbols

  试试:Find path from CreateUser to sql试试:Show call chain between these functions
• context

  Get node, source, callers, callees, and tests in one response

  试试:Get full context for ValidateToken试试:Show comprehensive info about this function
• trace

  Trace an error string backwards to entry points

  试试:Trace back 'parse failed' error试试:Find where this error originates
• deps

  Show direct or transitive import dependencies for a package

  试试:Show dependencies for internal/auth试试:List all transitive imports for this package

可对比工具

安装

# MacOS / Linux (通过Homebrew)
brew install ozgurcd/tap/gograph

# 或使用Go安装:
go install github.com/ozgurcd/gograph/cmd/gograph@latest

FAQ

gograph与gopls等语言服务器有何不同？

虽然gopls拥有类似的AST和类型数据，但将AI代理连接到它很困难且效率低下。gograph提取原生Markdown格式的精确结构切片，而不是简单的文件坐标，从而节省标记并为AI代理提供更好的上下文。

gograph是否支持Go以外的语言？

目前gograph仅解析和映射Go代码库。但是其架构可扩展，欢迎为其他语言贡献代码。

gograph 对比