Codeium 跨文件补全失效需五步解决：一、确保LSP全量索引项目并检查配置文件；二、启用MCP Server并重建索引；三、配置多根工作区覆盖子模块；四、校验符号导出与路径别名；五、禁用干扰插件并清除缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Codeium 进行代码编写时发现 AI 建议仅限于当前文件、无法识别其他文件中定义的函数或类，这通常源于 Codeium 对项目上下文的理解受限。以下是实现跨文件引用分析与补全的关键方法：
一、确保语言服务器正确加载并索引完整项目
Codeium 依赖后端语言服务器（LSP）构建项目级语义图谱，只有完成全量索引后，才能准确解析跨文件符号引用。未索引或索引中断将导致引用识别失败。
1、确认项目根目录下存在有效的语言配置文件，如 tsconfig.json（TypeScript）、pyproject.toml（Python）或 Cargo.toml（Rust）。
2、在 VS Code 或 JetBrains IDE 中，打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入并执行 “Codeium: Restart Language Server”。
3、观察右下角状态栏是否显示 “Indexing…” → “Ready”；若长期卡在“Indexing…”，需检查项目路径是否含中文、空格或符号链接。
二、启用 MCP Server 构建工程理解层
MCP（Model Context Protocol）Server 是 Codeium 实现跨文件语义分析的核心组件，它主动扫描整个工作区，生成结构化知识图谱，支持跨模块、跨语言的引用追踪与上下文感知补全。
1、确保已安装并启用 MCP Server：在 Codeium 设置中进入 “Settings → Advanced → Enable MCP Server”，勾选启用。
2、手动触发全项目扫描：在 VS Code 中按 Ctrl+Shift+P，运行命令 “Codeium: Rebuild Project Index”。
3、验证图谱生成状态：在终端中执行 codeium status --mcp，输出应包含 "graph_status: complete" 字样。
三、配置多根工作区以覆盖子模块引用
当项目由多个独立仓库或子模块（如 Git submodules、monorepo 中的 packages/ 目录）组成时，Codeium 默认仅索引主工作区根目录。需显式声明多根结构，使语言服务能联合解析各模块间引用关系。
1、在 VS Code 中，依次点击 “File → Add Folder to Workspace…”，添加所有相关子模块路径。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
2、保存为多根工作区文件（.code-workspace），并在该文件中确认各文件夹的 "path" 字段指向真实绝对路径。
3、重启 VS Code 后，执行 “Codeium: Reload Workspace Context” 命令，强制刷新跨根引用映射。
四、校验并修复符号可见性声明
即使索引完成，若目标符号未被正确导出或访问修饰符限制（如 TypeScript 的 private、Kotlin 的 internal、Rust 的 pub(crate)），Codeium 将无法将其纳入引用图谱。需确保跨文件可访问性符合语言规范。
1、检查被引用的函数/类是否具有公开导出声明：例如 TypeScript 中需含 export function helper()，而非仅 function helper()。
2、对于模块系统，确认导入路径正确且无循环依赖：在引用方文件中，运行 “Go to Definition” (F12) 应能成功跳转至源文件定义处。
3、若使用自定义路径别名（如 tsconfig.json 中的 paths），需在 codeium.json 配置中同步声明："typescript.paths": {"@utils/*": ["src/utils/*"]}。
五、禁用干扰型插件与缓存冲突
部分第三方插件（如旧版 ESLint、Prettier 扩展）或残留的本地语言服务器缓存可能劫持 LSP 请求，导致 Codeium 获取到错误的 AST 或跳过跨文件分析流程。
1、临时禁用所有非 Codeium 相关的语言增强插件，在 VS Code 中进入 “Extensions” 页面，关闭除 “Codeium” 外所有 LSP 类扩展。
2、清除 Codeium 本地缓存：在终端中执行 codeium clear-cache --lsp，随后重启编辑器。
3、验证是否解决：新建一个跨文件调用场景（如在 fileA.ts 中调用 fileB.ts 导出的函数），输入函数名前缀后，观察补全列表是否包含来自 fileB.ts 的候选项。
