CodeGeeX本地项目导入步骤

先说一个核心判断：想让 CodeGeeX 真正理解项目全貌，就得主动把项目根目录和关键文件（比如 pubspec.yaml、.csproj、pom.xml）喂给它，否则它只会盯着当前打开的单个文件瞎猜——结果就是生成的代码缺依赖、漏路由、忘继承主题，一跑就报错。

确认项目根目录已正确加载

在 VSCode 里，用 File → Open Folder（或快捷键 Ctrl+K Ctrl+O）打开那个包含 pubspec.yaml、.csproj、pom.xml 或 package.json 的最外层文件夹，千万别只点开一个 .dart 或 .java 文件就完事。如果右下角状态栏没有显示“Flutter SDK x.x.x”或“.NET SDK x.x.x”，那说明 CodeGeeX 压根没认出来这是什么项目，后续所有分析都会降级成纯文本理解，基本等于白干。 打开终端（Ctrl+`），执行 flutter pub get 或 dotnet build 验证一下命令能正常跑通。如果这一步都失败，CodeGeeX 就没法解析依赖图谱，后面再怎么问都是空中楼阁。

启用项目级上下文感知

点击左侧活动栏的 CodeGeeX 图标，切换到 Ask CodeGeeX 标签页，在输入框里输入 @file，弹出窗口会自动列出当前工作区所有已索引的文件。 勾选关键入口文件：Flutter 项目选 lib/main.dart 和 pubspec.yaml；WPF 项目选 App.xaml.cs 和 MainWindow.xaml；Java 项目选 pom.xml 和 src/main/java/xxx/Application.java。一次最多关联 3 个文件，再多就会触发截断警告。 这一步可千万别跳过——不显式关联文件的话，就算你在侧边栏问“如何修复 BuildContext 报错”，CodeGeeX 也看不到 MaterialApp 定义在哪里，只能泛泛而谈，给不出针对性方案。

用自然语言发起项目相关提问

方法一：直接提问（适合定位问题）

在已关联文件的前提下，输入：
@file lib/main.dart @file pubspec.yaml 当前登录页调用 Navigator.push 后白屏，可能原因有哪些？
CodeGeeX 会扫描路由表注册、BuildContext 生命周期、MaterialApp 是否包裹等真实项目约束条件，给出带上下文诊断。

方法二：指令驱动（适合批量操作）

输入：
@file lib/ @file pubspec.yaml 请为所有 StatefulWidget 自动生成 dispose() 方法，并在 initState 中添加 _controller = TextEditingController()
CodeGeeX 会遍历 lib/ 下全部 .dart 文件，只修改包含 State 类的文件，保留原有注释和空行格式。 注意：如果提问中没再次带上 @file 前缀，CodeGeeX 就会丢掉之前关联的上下文，瞬间退化成单文件模式，之前的努力全白费。

验证项目级分析是否生效

第一步：在侧边栏输入“列出本项目中所有网络请求发起点”。
正确响应应该包含 lib/network/api_client.dart、lib/screens/home_screen.dart 这样的真实路径，而不是笼统地回答“通常在 repository 层”。 第二步：选中某段报错代码（比如 FutureBuilder 内部异常），按 Alt+T 查看解释结果。如果出现“根据 pubspec.yaml 中 http: ^1.1.0 版本，此处需处理 DioErrorType.receiveTimeout”这类带版本号和配置依据的结论，说明上下文生效了。 如果两步都返回泛化描述（比如“常见于异步处理不当”），那项目上下文肯定没激活，得回到第一步重新打开根目录，确认状态栏 SDK 显示正常。