CodeGeeX在VSCode中无法上下文感知，很可能是项目未完成索引；需依次执行启用workspace索引、验证并手动重索引、配置索引范围与排除规则、检查索引日志四步操作。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在VSCode中使用CodeGeeX插件，但无法对当前项目代码进行上下文感知的问答或生成，则很可能是项目代码库尚未完成索引。以下是完成CodeGeeX全项目上下文理解所需的具体索引操作步骤：
一、启用并触发workspace索引
该步骤用于激活CodeGeeX对当前打开项目的全局代码扫描与语义建模能力，使其能基于整个代码库结构回答问题或生成符合上下文的代码。
1、在VSCode中，通过“文件”→“打开文件夹”完整加载目标项目根目录。
2、点击左侧活动栏中的CodeGeeX图标，或按快捷键唤出对话框。
3、在对话框中输入@workspace，或直接点击对话框左下角的文件夹图标按钮。
4、若为首次索引该项目，将弹出授权提示，点击同意启动索引流程。
5、等待右下角出现索引进度条并完成，此时文件夹图标保持常亮状态，表示索引已就绪。
二、验证索引状态与手动重索引
该步骤用于确认索引是否生效，并在索引异常（如新增大量文件后未自动更新）时强制刷新语义索引缓存。
1、观察CodeGeeX侧边栏顶部是否显示当前项目路径及“已索引”状态标识。
2、若状态异常或提示“索引不完整”，右键点击资源管理器中的项目根文件夹。
3、在右键菜单中选择“CodeGeeX: Re-index Workspace”选项。
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
4、确认执行后，查看底部状态栏是否出现“Re-indexing…”提示及后续完成通知。
三、配置索引范围与排除规则
该步骤用于控制索引覆盖的文件类型与目录路径，避免无意义文件（如node_modules、.git）拖慢索引速度或污染语义模型。
1、打开VSCode设置（Ctrl+,），搜索“codegeex indexing”。
2、找到“CodeGeeX: Indexing Include Pattern”设置项，填入需包含的glob模式，例如："**/*.ts,**/*.js,**/*.py"。
3、找到“CodeGeeX: Indexing Exclude Pattern”设置项，填入需跳过的路径，例如："**/node_modules/**,**/.git/**,**/__pycache__/**"。
4、修改后保存设置，重启VSCode使新规则在下次索引时生效。
四、检查索引日志与错误定位
该步骤用于排查索引失败原因，例如权限不足、路径过深、文件编码异常等底层问题。
1、按下Ctrl+Shift+P打开命令面板，输入并选择“Developer: Toggle Developer Tools”。
2、切换到Console标签页，筛选关键词“codegeex index”或“workspace indexing”。
3、查找红色错误信息，重点关注“EACCES”、“ENAMETOOLONG”、“Unsupported encoding”等提示。
4、根据具体报错调整对应文件权限、缩短路径深度，或在文件头部添加UTF-8 BOM声明。
