Qoder Agent 找不到文件或用错目录——工作区、路径、索引排查
问题现象
Agent 在执行任务时：
- 说找不到某个文件（明明存在）；
- 读写了错误的目录（比如改了
node_modules/而不是源码目录）； - 报错「路径不存在」但你确认路径没错；
- 跨项目时用了别的项目的文件。
第一步：确认工作区
在 Qoder IDE 的右下角或状态栏里查看当前 工作区（Workspace） 路径：
- Coding 模式：确认打开的项目目录是正确的那个；
- Quest / QoderWake：确认任务绑定的工作目录是你预期的。
常见错误：开错了项目、或工作区里有多个目录但 Agent 没搞清用哪个。
第二步：确认文件路径
让 Agent 帮你验证路径：
检查一下 C:\Users\XXX\projects\myapp\src\main.py 这个文件是否存在如果 Agent 返回不存在但你确认存在：
- 检查路径里有没有中文或特殊字符；
- 检查 Windows 路径分隔符（
\vs/）； - 检查大小写（macOS/Linux 大小写敏感，Windows 默认不敏感）。
第三步：检查目录权限
| 检查项 | 说明 |
|---|---|
| 只读属性 | 文件或目录是不是被设置成只读了 |
| 用户权限 | 当前用户有没有读写权限（Linux/macOS 用 ls -la 查） |
| 杀毒软件锁定 | 杀毒软件是不是把文件隔离了 |
| 被其他进程占用 | 有没有其他程序（如 IDE、git）锁住了文件 |
第四步：检查项目索引
Qoder IDE 打开项目后会 自动建立代码索引：
- 索引过程中 Agent 的搜索和理解能力可能不完整；
- 看右下角状态栏——有没有显示索引进度？有没有显示「索引完成」？
如果索引卡住了：
- 检查项目是不是太大（首次索引可能需要几分钟）；
- 检查有没有目录被过度排除；
- 在设置里手动触发重新索引。
第五步：检查排除规则
排除规则过宽可能导致 Agent 找不到文件：
- 进入设置 → 找到索引 / 排除规则；
- 默认排除的目录（node_modules、dist、vendor、.git 等）是合理的；
- 如果你手动加了太多排除规则，会导致 Agent 看不到必要的源码。
第六步：绝对路径验证
让 Agent 给出它理解的绝对路径，和你实际的绝对路径对比：
把你要操作的文件的完整路径告诉我如果和你预期的路径不一致——说明工作区或排除规则有问题。
特殊情况：跨盘访问
如果项目在 D 盘、临时目录在 C 盘：
- 确认 Qoder CN 有权限访问 D 盘；
- 如果是 macOS 上挂载了外接硬盘，可能需要在系统设置里给 Qoder CN 「完全磁盘访问权限」。
还不行
如果以上都试过还不行：
- 让 Agent 「列出工作区的根目录有哪些文件和文件夹」——看它实际看到了什么；
- 对比它列出的和你实际有的；
- 差异部分就是排除规则或权限的问题。
下一步
- 文件没问题，但命令执行报错 → 命令或工具执行失败
- MCP 服务启动失败 → MCP 服务常见问题