需先初始化项目索引并重启VSCode，才能使CodeGeeX解析跨文件调用链；其解释结果可转PlantUML绘图，或用code2flow生成静态调用图。
如何让插件理解跨文件调用链而非单个函数
CodeGeeX 默认只分析当前文件，对 Service 依赖的 Mapper、DTO 或配置类（如 application.yml 中的 mybatis.mapper-locations）完全不可见——生成的逻辑描述会断在第一层调用，比如只说 “调用了 insert()”，却不说明它最终执行哪段 SQL 或由哪个 XML 文件加载。
必须先触发项目级索引：确保工作区根目录有 pom.xml、build.gradle 或 pyproject.toml → 点击左下角 CodeGeeX 图标 → 选 “Initialize Project Index” → 等右下角提示 “Indexing completed: X files processed” → 重启 VSCode。不重启，索引不生效，后续所有解释仍是局部的。
重启后，光标停在任意 Service 方法名上，右键 → “Ask CodeGeeX → Explain Usage Across Project”，才能拿到含 Controller→Service→Mapper→SQL 的完整路径文本。
为什么不能直接让插件画图，而得转 PlantUML
CodeGeeX 本身不输出 SVG/PNG，也不集成图形渲染引擎；它只做语义解析和自然语言生成。但它的输出天然适合人工或半自动转成 @startuml 语法——因为调用关系本身就是线性、有向、无环的。
两种转换方式：
- 手动摘取解释结果中的箭头链，例如把 “
OrderService.process()→OrderMapper.insert()→ SQL 插入语句” 写成：@startuml OrderService --> OrderMapper OrderMapper --> "SQL XML File" @enduml
- 在 Ask CodeGeeX 输入框里直接喂指令：“请将以下调用链转为 PlantUML 语法：
Controller.handle()→Service.execute()→Repository.save()→Database.commit()”，它会返回标准块，复制粘贴即可。
注意：PlantUML 渲染依赖系统级 Graphviz（macOS 用 brew install graphviz，Windows 需下载安装包并配置 PATH），否则预览会报错 dot: command not found。
code2flow 是唯一能脱离 AI、复现性强的调用图方案
CodeGeeX 解释 + PlantUML 手动转写，适合快速验证关键路径；但若需全量、可存档、可 Git 提交的调用关系图，code2flow 是更可靠的选择——它基于 AST 静态分析，不依赖 LLM 输出，结果稳定、可复现。
使用前需全局安装：
npm install -g code2flow
生成 JS/TS 项目调用图示例：
code2flow src/**/*.ts --output callgraph.png
关键限制：
- 不支持跨语言调用（比如 Java 调 Python 不识别）
- 对动态 import、
eval、反射调用基本不可见 - 输出是 PNG/SVG，无法交互，但可嵌入 README 或 Confluence
容易被忽略的兼容性陷阱
PlantUML 插件（jebbs 版）和 code2flow 都依赖本地环境，但错误表现不同：
-
PlantUML: Preview按下没反应？大概率是dot命令未加入 PATH，不是插件没装好 -
code2flow报 “No functions found”？检查 glob 路径是否匹配实际文件（如src/**/*.{js,ts}而非**/*.js） - CodeGeeX 解释中出现 “xxx is injected by Spring” 却没展开？说明索引时没识别到 Spring Boot 的
@Configuration类，需确认spring-boot-starter相关依赖是否在pom.xml中且被正确解析
真正卡住的地方往往不是语法或指令，而是这些底层工具链的隐式依赖——它们不会主动报错，只会静默失败。
