拓冰网站定制 
CodeGraph 框架路由解析从 URL 模式到 Handler 的 route 节点与 references 边【免费下载链接】codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local项目地址: https://gitcode.com/GitHub_Trending/co0degr/codegraph本文以 CodeGraph 官方文档《Framework Routes》为主体系统讲解 CodeGraph 如何自动识别 Web 框架的路由声明把它们转换成图中的route节点并通过references边绑定到实际的 handler 类或函数。读完本文你将了解覆盖 18 类框架的路由识别形态、detect → extract → resolve的完整管线在源码中的具体实现以及 route 节点被查询与验证的方式——这一切都是自动完成的无需任何配置。CodeGraph 对路由处理的核心机制可以概括为一句话识别 Web 框架的路由文件发出route节点并用references边将其链接到提供该路由的 handler 类或函数这样查询某个视图或控制器的调用方callers时绑定它的 URL 模式就会随之浮现。对 Agent 来说这意味着回答这个接口暴露在哪个 URL 上改这个 handler 会影响哪些端点这类问题时不需要再靠 grep 路由表来拼凑答案。支持的框架与识别形态官方文档给出了 CodeGraph 可识别的完整框架清单。下表完整继承自 framework-routes.md每一行的识别形态都能在对应的框架解析器源码中找到正则或扫描逻辑框架识别的形态Djangourls.py中的path()、re_path()、url()、include()含 CBV 的.as_view()、点分路径Flaskapp.route(/path, methods[...])、blueprint 路由FastAPIapp.get(...)、router.post(...)覆盖所有标准 HTTP 方法Express带中间件链的app.get(...)、router.post(...)NestJSControllerGet/Post/...、GraphQL 的ResolverQuery/Mutation、MessagePattern/EventPattern、SubscribeMessageLaravelRoute::get()、Route::resource()、Controlleraction、元组语法Drupal*.routing.yml路由_controller、_form、实体 handler.module/.theme/.install/.inc中的hook_*实现Railsget /x, to: users#index、hash-rocket语法Spring方法上的GetMapping、PostMapping、RequestMappingPlayconf/routes中的GET/POST/… 动词路由 →Controller.methodactionScala JavaGin / chi / gorilla / muxr.GET(...)、router.HandleFunc(...)Axum / actix / Rocket.route(/x, get(handler))ASP.NETaction 方法上的[HttpGet(/x)]特性Vaporapp.get(x, use: handler)React Router/SvelteKit路由组件节点Vue Router/Nuxtpages/文件式路由、server/api/端点、路由中间件Astrosrc/pages/文件式路由.astro页面 .ts端点含[param]/[...rest]语法这些解析器统一注册在框架解析器注册表中src/resolution/frameworks/index.ts 的FRAMEWORK_RESOLVERS数组按 PHP、JavaScript/TypeScript、Python、Ruby、Java、Go、Rust、C#、Swift 等语言分组登记了laravelResolver、drupalResolver、expressResolver、nestjsResolver、reactResolver、vueResolver、astroResolver、djangoResolver、flaskResolver、fastapiResolver、railsResolver、springResolver、goResolver、rustResolver、aspnetResolver、vaporResolver等条目。注册表同时提供getFrameworkResolver(name)按名查找、detectFrameworks(context)项目级探测、以及registerFrameworkResolver()供扩展注册的入口。三段式管线detect、extract、resolveroute能力来自 src/resolution/types.ts 中FrameworkResolver接口定义的三个关键成员这也是理解所有框架解析器行为的钥匙detect(context)—— 项目级框架探测启动时调用一次决定该项目启用哪些框架解析器。extract?(filePath, content)—— 从单个文件中提取框架专属的节点与引用返回FrameworkExtractionResult即{ nodes, references }框架专属节点如 routes与框架专属未解析引用如 route → handler都在这里产出。resolve(ref, context)—— 把extract产出的未解析引用落图引用的常规解析管线会把框架自己的resolve()作为其中一种策略尝试接口注释明确写道Unresolved references flow into the normal resolution pipeline; the frameworks ownresolve()is one of the strategies tried.此外还有两个值得注意的可选钩子claimsReference?(name)让某个引用名称绕过无同名节点即丢弃的预过滤。接口注释举例Django 的self._iterable_class(...)是属性而非声明符号必须靠这个钩子才能到达resolve()。Laravel 用同一机制认领Controllermethod形式的引用见下文 PHP 一节。postExtract?(context)跨文件收尾遍用于符号的最终形态依赖兄弟文件的框架例如 NestJS 的RouterModule.register([...])会为声明在别处的控制器补上路由前缀。实现必须保留节点id以维持既有边且应保持qualifiedName幂等。extract的挂载点在主抽取流程中。src/extraction/tree-sitter.ts 的extractFromSource()函数头注释说明当传入frameworkNames时与文件名、文件语言匹配的框架专属提取器会在 tree-sitter 解析遍之后运行其 nodes/references/errors 合并进返回结果。也就是说 route 节点与普通函数/类节点共享同一份图数据且随索引/同步自动刷新——这正是文档所说框架文件被识别后其路由会在下一次索引或同步后出现在图中的机制来源。各框架解析器的实现细节Python 系Django、Flask、FastAPI三个解析器同源于 src/resolution/frameworks/python.ts。**项目探测detect**各不相同可以理解为每个框架的指纹Django依次读取requirements.txt、setup.py、pyproject.toml是否含django最后兜底fileExists(manage.py)Flask依赖清单中含flask或者在app|application|main|wsgi|__init__.py命名的入口文件最多扫 50 个中发现import flask与Flask(...)实例化——注释说明这覆盖Flask(__name__)与 app-factory 模式FastAPI依赖清单含fastapi或app.py/main.py/api.py中出现FastAPI(。Django 路由提取用的核心正则是const routeRegex /\b(path|re_path|url)\s*\(\s*r?[]\s*,\s*([\w.](?:\s*\([^)]*\))?)/g;它捕获三个组函数名path/re_path/url、URL 字符串、handler 表达式允许一对平衡括号以容纳View.as_view()或include(x.y)。匹配后生成kind: route的节点name即 URL 路径qualifiedName为${filePath}::route:${urlPath}。handler 表达式交给resolveHandlerName()解析include(module.path)产出imports类型引用被包含的 URLconf 由此对根 URLconf 记一条依赖其余情况先剥掉尾部.as_view(...)等调用取点分名的最后一段作为references引用。此外还有一条专门针对 DRF 的规则router.register(rarticles, ArticleViewSet)会产出name为VIEWSET /articles的 route 节点并引用该 ViewSet 类。源码注释解释了区分逻辑——第一个参数是字符串这一点把它与admin.site.register(Model, Admin)首参是类分开第二个参数的View/ViewSet后缀限定它只匹配 DRF viewset。Flask 与 FastAPI 共用装饰器提取器extractDecoratorRoutes()二者只是正则与分组不同Flask(\w)\.route\(\s*])[\])])?\s*\)默认方法GET方法可从methods[...]列表中取出FastAPI(\w)\.(get|post|put|patch|delete|options|head)\(\s*[]方法名直接取自装饰器名注释指出路径可为空字符串表示挂载在 router/前缀根上。handler 的定位逻辑是findHandler在装饰器之后寻找下一个\n\s*(?:async\s)?def\s(\w)从而兼容装饰器与def之间夹着login_required等其它装饰器的情形。route 节点的name统一为${METHOD} ${routePath || /}形式id为route:${filePath}:${line}:${method}:${routePath}——文件 行号 方法 路径构成确定性标识保证增量同步时的幂等。Flask 还额外覆盖 Flask-RESTfulextractFlaskRestful()匹配.add*Resource(Class, /path, /path2)对每个路径产出name为ANY /path的 route 节点并引用资源类——注释说明 ResourceClass 持有get/post/...等动词方法所以引用落在类上具体 handler 经类可达。框架侧 resolve 策略同样值得看Django 解析器对*Model、*View/*ViewSet、*Form三类后缀引用用resolveByNameAndKind()在约定目录models/、views/、forms/等中优先挑候选命中则给 0.8 的置信度并以resolvedBy: framework记边FastAPI 对*_router/router变量和Depends(...)依赖项做同类处理0.75 置信度。JavaScript/TypeScript 系Express、NestJS 与前端路由Expresssrc/resolution/frameworks/express.ts的detect先看package.json的dependencies/devDependencies是否含express/fastify/koa/hapi再兜底扫描路径含routes/controllers/middleware的文件内容。提取时只匹配路由头const head /\b(app|router)\.(get|post|put|patch|delete|all|use)\s*\(\s*[]\s*,/g;源码注释解释了为什么刻意不匹配整个调用handler 常是内联箭头函数res.json(...)、嵌套}会让整调正则失配导致内联 handler 路由连不上任何东西。改为在use且路径不以/开头时跳过把app.use(/api, router)这类挂载与路由区分开。resolve侧则处理中间件名0.8 置信度、XxxController.method0.85、XxxService/Helper/Utils.method0.8三类引用并用RESERVED_CALLS集合把res.json、req.body等框架噪音调用排除在路由边之外。NestJSsrc/resolution/frameworks/nestjs.ts的提取逻辑分四路HTTP 路由先用buildClassScopes()建立类作用域Get/Post/...装饰器所在行若落在Controller作用域内则把控制器前缀与方法装饰器路径拼接成完整路径joinHttpPath(prefix, parseStringArg(hit.args))handler 取装饰器后第一个方法名GraphQL 操作Query/Mutation/...只在Resolver作用域内生效——注释点明这是为了与Controller类里同名的 REST 参数装饰器Query()消歧微服务消息/事件MessagePattern/EventPattern产出MESSAGE/EVENT前缀的 route 节点路由节点统一经内部addRoute()生成id为route:${filePath}:${line}:${method}:${path}。跨文件的前缀补全RouterModule.register([...])则由接口中的postExtract钩子承担见上文管线一节。前端路由React Router / SvelteKit / Vue / Nuxt / Astro的语义不同它们产出的是路由组件节点。测试tests/frameworks.test.ts 展示了 React 解析器对多种写法的覆盖v6 写法Route path/users element{UsersPage/}/→ route 名/users引用UsersPagev5 写法Route exact path/login component{Login} /属性顺序任意→ route 名/login引用LoginRoutes容器本身不算路由createBrowserRouter([{ path: /dashboard, element: Dashboard / }, ...])对象式路由也能提取负例同样被测过next.config.mjs与vite.config.ts不会误报为 Next.js 路由而真实的src/pages/about.tsx会产出/about。PHP 系Laravel 与 DrupalLaravelsrc/resolution/frameworks/laravel.ts的detect极其简单artisan文件或app/Http/Kernel.php存在即命中。路由提取正则Route::(get|post|put|patch|delete|options|any)\s*\(\s*[]\s*,\s*([^)])\)捕获方法与 handler 表达式handler 支持[Class::class, method]元组、Controllermethod字符串、闭包、Class::class等形态Route::resource/apiResource则产出name为resource:name的节点并引用控制器类。Controlleraction引用是名字不指向任何声明符号的典型靠claimsReference(name)钩子放行正则^[A-Za-z_][\w]*Controller\w$再由resolve的 Pattern 4 以 0.9 置信度解析到控制器方法——这是FrameworkResolver接口注释中专门点名的场景。文件顶部还导出一份FACADE_MAPPINGSAuth → Illuminate\Auth\AuthManager、Route → Illuminate\Routing\Router等 20 余项供门面解析复用而Auth::user()这类门面调用本身会被识别为外部代码、返回null不在本地图上造虚节点。Drupal解析器src/resolution/frameworks/drupal.ts按文档所述覆盖*.routing.yml_controller、_form、实体 handler与hook_*实现仓库中另有专项测试tests/drupal.test.ts 与之对应。文件式路由Vue/Nuxt 与 Astro文件式路由的 route 节点不由语法匹配产生而是由文件路径本身推导。以 Astro 为例src/resolution/frameworks/astro.ts 的extract只处理src/pages/下的.astro/.ts/.js/.mjs文件.md/.mdx页面存在但不作为源码索引含下划线前缀路径段的文件被 Astro 排除出路由解析器同样跳过pages 目录下误放的*.config.*文件永不视为路由其余文件经filePathToAstroRoute()把blog/index.astro → /blog、[param]/[...rest]动态段转换为路由名产出startLine: 1的 route 节点。测试frameworks.test.ts 中astroResolver.extract — src/pages file-based routing一节确认了index.astro → /、blog/index.astro → /blog、about.astro → /about以及[param]/[...rest]的转换。Vue/Nuxt解析器src/resolution/frameworks/vue.ts按文档覆盖pages/文件式路由、server/api/端点与路由中间件detect先看package.json是否含vue/nuxt/nuxt/kit再兜底是否存在.vue文件。其resolve侧还内置了 Vue 3 编译器宏白名单defineProps、defineEmits等 7 项自引用、置信度 1.0与 Nuxt 自动导入集合useRoute、navigateTo、useFetch、definePageMeta等 30 余项避免这些框架提供的标识符被误当成用户符号去重名匹配。其它语言GoGin/chi/gorilla/mux 及 GoFramesrc/resolution/frameworks/go.ts 与 goframe.ts、RustAxum/actix/Rocketrust.ts、C#[HttpGet(/x)]特性csharp.ts、JavaSpring 注解 Playconf/routesjava.ts 与 play.ts、SwiftVaporswift.ts与 RubyRailsruby.ts的解析器均实现了同样的extract契约——search_in_files检索kind: route可在每个文件里看到一致的节点构造模式route:前缀的确定性id、filePath::METHOD:path形式的qualifiedName、以及指向 handler 的references引用。验证route 能力如何被测试与查询测试层。tests/frameworks.test.ts1800 余行按框架组织用例React Router 五种形态、SvelteKit 冒烟、Astro 路径映射等tests/explore-allocation-1500.test.ts 中还能看到断言n.kind route的用法说明 route 节点会进入 explore 等上下文分配流程。专项测试还包括tests/laravel-event-synthesizer.test.ts、tests/gin-middleware-chain.test.ts、tests/goframe.test.ts、tests/drupal.test.ts 等与文档表格中的框架清单一一对应。查询层。route 是一等查询目标MCP 工具定义src/mcp/tools.ts把route列入可按kind过滤的节点类型枚举function, method, class, interface, type, variable, route, component。因此查询某视图/控制器的调用方 → 浮现绑定它的 URL 模式在工具层面是对该 handler 节点取调用方图中指向它的route节点自然出现在结果里反向地按kind: route检索可列出全部端点再顺着其references边定位 handler。总结零配置随索引自动生效回到文档结论路由解析是全自动的没有任何可配置项。项目里只要出现框架特征文件route 节点就会在下一次索引或同步后进入图。把整条链路串起来看探测——detectFrameworks()对注册表中每个解析器跑detect(context)异常会被捕获并视为未检出单个框架的探测失败不影响其它框架提取——每个被索引文件走extractFromSource()tree-sitter 遍产出符号节点后命中该语言的框架extract()追加 route 节点与 route→handler 引用解析——引用进入常规解析管线框架resolve()按后缀/前缀/目录约定策略落边resolvedBy: framework标记边来源与置信度收尾——需要跨文件信息的框架如 NestJS 前缀补全用postExtract做幂等修正id与qualifiedName的保留约束保证既有 route→handler 边不被破坏。对使用 CodeGraph 的 Agent 而言这套机制的价值在于把URL 模式 ↔ handler这对在静态调用图里天然缺失的关系补了回来新增端点、排查接口变更影响面、回答这个 URL 由哪段代码处理都可以在图上一跳到达而不必再退回全文搜索路由文件。【免费下载链接】codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local项目地址: https://gitcode.com/GitHub_Trending/co0degr/codegraph创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 CodeGraph 框架路由解析：从 URL 模式到 Handler 的 route 节点与 references 边
CodeGraph 框架路由解析从 URL 模式到 Handler 的 route 节点与 references 边【免费下载链接】codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local项目地址: https://gitcode.com/GitHub_Trending/co0degr/codegraph本文以 CodeGraph 官方文档《Framework Routes》为主体系统讲解 CodeGraph 如何自动识别 Web 框架的路由声明把它们转换成图中的route节点并通过references边绑定到实际的 handler 类或函数。读完本文你将了解覆盖 18 类框架的路由识别形态、detect → extract → resolve的完整管线在源码中的具体实现以及 route 节点被查询与验证的方式——这一切都是自动完成的无需任何配置。CodeGraph 对路由处理的核心机制可以概括为一句话识别 Web 框架的路由文件发出route节点并用references边将其链接到提供该路由的 handler 类或函数这样查询某个视图或控制器的调用方callers时绑定它的 URL 模式就会随之浮现。对 Agent 来说这意味着回答这个接口暴露在哪个 URL 上改这个 handler 会影响哪些端点这类问题时不需要再靠 grep 路由表来拼凑答案。支持的框架与识别形态官方文档给出了 CodeGraph 可识别的完整框架清单。下表完整继承自 framework-routes.md每一行的识别形态都能在对应的框架解析器源码中找到正则或扫描逻辑框架识别的形态Djangourls.py中的path()、re_path()、url()、include()含 CBV 的.as_view()、点分路径Flaskapp.route(/path, methods[...])、blueprint 路由FastAPIapp.get(...)、router.post(...)覆盖所有标准 HTTP 方法Express带中间件链的app.get(...)、router.post(...)NestJSControllerGet/Post/...、GraphQL 的ResolverQuery/Mutation、MessagePattern/EventPattern、SubscribeMessageLaravelRoute::get()、Route::resource()、Controlleraction、元组语法Drupal*.routing.yml路由_controller、_form、实体 handler.module/.theme/.install/.inc中的hook_*实现Railsget /x, to: users#index、hash-rocket语法Spring方法上的GetMapping、PostMapping、RequestMappingPlayconf/routes中的GET/POST/… 动词路由 →Controller.methodactionScala JavaGin / chi / gorilla / muxr.GET(...)、router.HandleFunc(...)Axum / actix / Rocket.route(/x, get(handler))ASP.NETaction 方法上的[HttpGet(/x)]特性Vaporapp.get(x, use: handler)React Router/SvelteKit路由组件节点Vue Router/Nuxtpages/文件式路由、server/api/端点、路由中间件Astrosrc/pages/文件式路由.astro页面 .ts端点含[param]/[...rest]语法这些解析器统一注册在框架解析器注册表中src/resolution/frameworks/index.ts 的FRAMEWORK_RESOLVERS数组按 PHP、JavaScript/TypeScript、Python、Ruby、Java、Go、Rust、C#、Swift 等语言分组登记了laravelResolver、drupalResolver、expressResolver、nestjsResolver、reactResolver、vueResolver、astroResolver、djangoResolver、flaskResolver、fastapiResolver、railsResolver、springResolver、goResolver、rustResolver、aspnetResolver、vaporResolver等条目。注册表同时提供getFrameworkResolver(name)按名查找、detectFrameworks(context)项目级探测、以及registerFrameworkResolver()供扩展注册的入口。三段式管线detect、extract、resolveroute能力来自 src/resolution/types.ts 中FrameworkResolver接口定义的三个关键成员这也是理解所有框架解析器行为的钥匙detect(context)—— 项目级框架探测启动时调用一次决定该项目启用哪些框架解析器。extract?(filePath, content)—— 从单个文件中提取框架专属的节点与引用返回FrameworkExtractionResult即{ nodes, references }框架专属节点如 routes与框架专属未解析引用如 route → handler都在这里产出。resolve(ref, context)—— 把extract产出的未解析引用落图引用的常规解析管线会把框架自己的resolve()作为其中一种策略尝试接口注释明确写道Unresolved references flow into the normal resolution pipeline; the frameworks ownresolve()is one of the strategies tried.此外还有两个值得注意的可选钩子claimsReference?(name)让某个引用名称绕过无同名节点即丢弃的预过滤。接口注释举例Django 的self._iterable_class(...)是属性而非声明符号必须靠这个钩子才能到达resolve()。Laravel 用同一机制认领Controllermethod形式的引用见下文 PHP 一节。postExtract?(context)跨文件收尾遍用于符号的最终形态依赖兄弟文件的框架例如 NestJS 的RouterModule.register([...])会为声明在别处的控制器补上路由前缀。实现必须保留节点id以维持既有边且应保持qualifiedName幂等。extract的挂载点在主抽取流程中。src/extraction/tree-sitter.ts 的extractFromSource()函数头注释说明当传入frameworkNames时与文件名、文件语言匹配的框架专属提取器会在 tree-sitter 解析遍之后运行其 nodes/references/errors 合并进返回结果。也就是说 route 节点与普通函数/类节点共享同一份图数据且随索引/同步自动刷新——这正是文档所说框架文件被识别后其路由会在下一次索引或同步后出现在图中的机制来源。各框架解析器的实现细节Python 系Django、Flask、FastAPI三个解析器同源于 src/resolution/frameworks/python.ts。**项目探测detect**各不相同可以理解为每个框架的指纹Django依次读取requirements.txt、setup.py、pyproject.toml是否含django最后兜底fileExists(manage.py)Flask依赖清单中含flask或者在app|application|main|wsgi|__init__.py命名的入口文件最多扫 50 个中发现import flask与Flask(...)实例化——注释说明这覆盖Flask(__name__)与 app-factory 模式FastAPI依赖清单含fastapi或app.py/main.py/api.py中出现FastAPI(。Django 路由提取用的核心正则是const routeRegex /\b(path|re_path|url)\s*\(\s*r?[]\s*,\s*([\w.](?:\s*\([^)]*\))?)/g;它捕获三个组函数名path/re_path/url、URL 字符串、handler 表达式允许一对平衡括号以容纳View.as_view()或include(x.y)。匹配后生成kind: route的节点name即 URL 路径qualifiedName为${filePath}::route:${urlPath}。handler 表达式交给resolveHandlerName()解析include(module.path)产出imports类型引用被包含的 URLconf 由此对根 URLconf 记一条依赖其余情况先剥掉尾部.as_view(...)等调用取点分名的最后一段作为references引用。此外还有一条专门针对 DRF 的规则router.register(rarticles, ArticleViewSet)会产出name为VIEWSET /articles的 route 节点并引用该 ViewSet 类。源码注释解释了区分逻辑——第一个参数是字符串这一点把它与admin.site.register(Model, Admin)首参是类分开第二个参数的View/ViewSet后缀限定它只匹配 DRF viewset。Flask 与 FastAPI 共用装饰器提取器extractDecoratorRoutes()二者只是正则与分组不同Flask(\w)\.route\(\s*])[\])])?\s*\)默认方法GET方法可从methods[...]列表中取出FastAPI(\w)\.(get|post|put|patch|delete|options|head)\(\s*[]方法名直接取自装饰器名注释指出路径可为空字符串表示挂载在 router/前缀根上。handler 的定位逻辑是findHandler在装饰器之后寻找下一个\n\s*(?:async\s)?def\s(\w)从而兼容装饰器与def之间夹着login_required等其它装饰器的情形。route 节点的name统一为${METHOD} ${routePath || /}形式id为route:${filePath}:${line}:${method}:${routePath}——文件 行号 方法 路径构成确定性标识保证增量同步时的幂等。Flask 还额外覆盖 Flask-RESTfulextractFlaskRestful()匹配.add*Resource(Class, /path, /path2)对每个路径产出name为ANY /path的 route 节点并引用资源类——注释说明 ResourceClass 持有get/post/...等动词方法所以引用落在类上具体 handler 经类可达。框架侧 resolve 策略同样值得看Django 解析器对*Model、*View/*ViewSet、*Form三类后缀引用用resolveByNameAndKind()在约定目录models/、views/、forms/等中优先挑候选命中则给 0.8 的置信度并以resolvedBy: framework记边FastAPI 对*_router/router变量和Depends(...)依赖项做同类处理0.75 置信度。JavaScript/TypeScript 系Express、NestJS 与前端路由Expresssrc/resolution/frameworks/express.ts的detect先看package.json的dependencies/devDependencies是否含express/fastify/koa/hapi再兜底扫描路径含routes/controllers/middleware的文件内容。提取时只匹配路由头const head /\b(app|router)\.(get|post|put|patch|delete|all|use)\s*\(\s*[]\s*,/g;源码注释解释了为什么刻意不匹配整个调用handler 常是内联箭头函数res.json(...)、嵌套}会让整调正则失配导致内联 handler 路由连不上任何东西。改为在use且路径不以/开头时跳过把app.use(/api, router)这类挂载与路由区分开。resolve侧则处理中间件名0.8 置信度、XxxController.method0.85、XxxService/Helper/Utils.method0.8三类引用并用RESERVED_CALLS集合把res.json、req.body等框架噪音调用排除在路由边之外。NestJSsrc/resolution/frameworks/nestjs.ts的提取逻辑分四路HTTP 路由先用buildClassScopes()建立类作用域Get/Post/...装饰器所在行若落在Controller作用域内则把控制器前缀与方法装饰器路径拼接成完整路径joinHttpPath(prefix, parseStringArg(hit.args))handler 取装饰器后第一个方法名GraphQL 操作Query/Mutation/...只在Resolver作用域内生效——注释点明这是为了与Controller类里同名的 REST 参数装饰器Query()消歧微服务消息/事件MessagePattern/EventPattern产出MESSAGE/EVENT前缀的 route 节点路由节点统一经内部addRoute()生成id为route:${filePath}:${line}:${method}:${path}。跨文件的前缀补全RouterModule.register([...])则由接口中的postExtract钩子承担见上文管线一节。前端路由React Router / SvelteKit / Vue / Nuxt / Astro的语义不同它们产出的是路由组件节点。测试tests/frameworks.test.ts 展示了 React 解析器对多种写法的覆盖v6 写法Route path/users element{UsersPage/}/→ route 名/users引用UsersPagev5 写法Route exact path/login component{Login} /属性顺序任意→ route 名/login引用LoginRoutes容器本身不算路由createBrowserRouter([{ path: /dashboard, element: Dashboard / }, ...])对象式路由也能提取负例同样被测过next.config.mjs与vite.config.ts不会误报为 Next.js 路由而真实的src/pages/about.tsx会产出/about。PHP 系Laravel 与 DrupalLaravelsrc/resolution/frameworks/laravel.ts的detect极其简单artisan文件或app/Http/Kernel.php存在即命中。路由提取正则Route::(get|post|put|patch|delete|options|any)\s*\(\s*[]\s*,\s*([^)])\)捕获方法与 handler 表达式handler 支持[Class::class, method]元组、Controllermethod字符串、闭包、Class::class等形态Route::resource/apiResource则产出name为resource:name的节点并引用控制器类。Controlleraction引用是名字不指向任何声明符号的典型靠claimsReference(name)钩子放行正则^[A-Za-z_][\w]*Controller\w$再由resolve的 Pattern 4 以 0.9 置信度解析到控制器方法——这是FrameworkResolver接口注释中专门点名的场景。文件顶部还导出一份FACADE_MAPPINGSAuth → Illuminate\Auth\AuthManager、Route → Illuminate\Routing\Router等 20 余项供门面解析复用而Auth::user()这类门面调用本身会被识别为外部代码、返回null不在本地图上造虚节点。Drupal解析器src/resolution/frameworks/drupal.ts按文档所述覆盖*.routing.yml_controller、_form、实体 handler与hook_*实现仓库中另有专项测试tests/drupal.test.ts 与之对应。文件式路由Vue/Nuxt 与 Astro文件式路由的 route 节点不由语法匹配产生而是由文件路径本身推导。以 Astro 为例src/resolution/frameworks/astro.ts 的extract只处理src/pages/下的.astro/.ts/.js/.mjs文件.md/.mdx页面存在但不作为源码索引含下划线前缀路径段的文件被 Astro 排除出路由解析器同样跳过pages 目录下误放的*.config.*文件永不视为路由其余文件经filePathToAstroRoute()把blog/index.astro → /blog、[param]/[...rest]动态段转换为路由名产出startLine: 1的 route 节点。测试frameworks.test.ts 中astroResolver.extract — src/pages file-based routing一节确认了index.astro → /、blog/index.astro → /blog、about.astro → /about以及[param]/[...rest]的转换。Vue/Nuxt解析器src/resolution/frameworks/vue.ts按文档覆盖pages/文件式路由、server/api/端点与路由中间件detect先看package.json是否含vue/nuxt/nuxt/kit再兜底是否存在.vue文件。其resolve侧还内置了 Vue 3 编译器宏白名单defineProps、defineEmits等 7 项自引用、置信度 1.0与 Nuxt 自动导入集合useRoute、navigateTo、useFetch、definePageMeta等 30 余项避免这些框架提供的标识符被误当成用户符号去重名匹配。其它语言GoGin/chi/gorilla/mux 及 GoFramesrc/resolution/frameworks/go.ts 与 goframe.ts、RustAxum/actix/Rocketrust.ts、C#[HttpGet(/x)]特性csharp.ts、JavaSpring 注解 Playconf/routesjava.ts 与 play.ts、SwiftVaporswift.ts与 RubyRailsruby.ts的解析器均实现了同样的extract契约——search_in_files检索kind: route可在每个文件里看到一致的节点构造模式route:前缀的确定性id、filePath::METHOD:path形式的qualifiedName、以及指向 handler 的references引用。验证route 能力如何被测试与查询测试层。tests/frameworks.test.ts1800 余行按框架组织用例React Router 五种形态、SvelteKit 冒烟、Astro 路径映射等tests/explore-allocation-1500.test.ts 中还能看到断言n.kind route的用法说明 route 节点会进入 explore 等上下文分配流程。专项测试还包括tests/laravel-event-synthesizer.test.ts、tests/gin-middleware-chain.test.ts、tests/goframe.test.ts、tests/drupal.test.ts 等与文档表格中的框架清单一一对应。查询层。route 是一等查询目标MCP 工具定义src/mcp/tools.ts把route列入可按kind过滤的节点类型枚举function, method, class, interface, type, variable, route, component。因此查询某视图/控制器的调用方 → 浮现绑定它的 URL 模式在工具层面是对该 handler 节点取调用方图中指向它的route节点自然出现在结果里反向地按kind: route检索可列出全部端点再顺着其references边定位 handler。总结零配置随索引自动生效回到文档结论路由解析是全自动的没有任何可配置项。项目里只要出现框架特征文件route 节点就会在下一次索引或同步后进入图。把整条链路串起来看探测——detectFrameworks()对注册表中每个解析器跑detect(context)异常会被捕获并视为未检出单个框架的探测失败不影响其它框架提取——每个被索引文件走extractFromSource()tree-sitter 遍产出符号节点后命中该语言的框架extract()追加 route 节点与 route→handler 引用解析——引用进入常规解析管线框架resolve()按后缀/前缀/目录约定策略落边resolvedBy: framework标记边来源与置信度收尾——需要跨文件信息的框架如 NestJS 前缀补全用postExtract做幂等修正id与qualifiedName的保留约束保证既有 route→handler 边不被破坏。对使用 CodeGraph 的 Agent 而言这套机制的价值在于把URL 模式 ↔ handler这对在静态调用图里天然缺失的关系补了回来新增端点、排查接口变更影响面、回答这个 URL 由哪段代码处理都可以在图上一跳到达而不必再退回全文搜索路由文件。【免费下载链接】codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local项目地址: https://gitcode.com/GitHub_Trending/co0degr/codegraph创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考