使用 Codex 处理本地项目时，有一类问题非常常见：

明明项目文件就在电脑里，Codex却一直提示找不到文件、无法读取目录，或者只能看到一部分代码。

有时候甚至会出现：

• 能看到项目根目录，却看不到某个子目录；
• 能读取代码，但修改时提示没有权限；
• 明明文件真实存在，却提示路径不存在；
• 切换项目以后，Codex还在访问之前的目录；
• 让它修改某个文件，它却一直说“找不到该文件”。

这类问题很多时候不是模型不会写代码，而是工作区、路径或者权限没有对上。

下面可以按照这个顺序排查。

一、先确认Codex当前到底打开了哪个项目

这是最容易被忽略的一步。

例如你的真实项目在：

D:\projects\my-app

但当前 Codex 实际工作的目录可能还是：

D:\projects

或者甚至是另外一个旧项目。

这时候你让它读取：

src/app.ts

Codex就可能按照当前工作目录去寻找，自然会出现文件不存在。

所以遇到读取失败，第一步不要急着改权限。

先让它确认：

当前工作目录是什么？
列出当前目录下的主要文件和文件夹。

先把“它现在在哪里”搞清楚。

二、检查相对路径和绝对路径

开发过程中经常会混用两种路径。

例如：

src/config/index.ts

这是相对路径。

而：

D:\projects\my-app\src\config\index.ts

这是完整路径。

如果当前工作目录发生变化，相对路径就可能失效。

例如当前目录已经进入：

D:\projects\my-app\src

你再让它读取：

src/config/index.ts

实际相当于让它去寻找：

D:\projects\my-app\src\src\config\index.ts

自然就找不到了。

所以排查时，可以先确认目录树，再使用准确路径。

比起一直说：

帮我打开那个配置文件。

更推荐直接告诉它：

检查当前项目中的 src/config/index.ts 是否存在，如果不存在，先搜索项目中名称为 index.ts 的相关文件。

这样稳定很多。

三、文件存在，不代表当前环境一定有权限读取

第二种情况是：

路径没有错，但访问权限不够。

尤其是项目放在这些位置时，更容易遇到权限问题：

• 系统目录；
• 其他用户目录；
• 受保护文件夹；
• 网络磁盘；
• 企业电脑受管控目录；
• 某些同步盘目录。

这种情况下，Codex可能能够看到目录名称，但执行读取、修改或者写入操作时失败。

可以先判断一个问题：

这个目录你当前运行 Codex 的用户账号能不能正常读写？

最简单的方法，就是自己尝试：

新建一个文件；

修改一个文件；

删除测试文件。

如果系统本身都需要管理员权限，那么 Codex执行修改时同样可能受到限制。

四、检查项目是不是只打开了一部分目录

另一个非常容易踩坑的情况是：

完整项目结构是：

my-app
├── frontend
├── backend
├── scripts
└── docs

但你实际只把：

my-app/frontend

作为当前工作区打开了。

这时候你让 Codex读取：

backend/api/server.js

它自然无法找到。

因为从当前工作区来看，backend 根本不存在。

这种问题在前后端分离项目、Monorepo、多模块项目里特别常见。

如果一个任务涉及多个目录，最好一开始就确认：

当前工作区是否包含这次任务需要修改的全部代码。

五、不要一上来就让Codex修改，先让它扫描目录

如果项目比较大，我更推荐一种工作方式：

先让 Codex 做一次结构确认。

例如：

先不要修改任何代码。

请检查当前项目目录结构，
确认 src、config、tests 和 package.json 是否存在，
并告诉我你能够访问哪些目录。

等它确认完以后，再继续：

现在读取 src/services/user.ts，
分析这个文件里的登录逻辑。

这样做有一个很大的好处：

你可以在真正修改代码之前，就发现路径或者工作区问题。

否则任务跑到一半才发现文件根本没打开，会浪费很多时间。

六、注意文件名大小写和特殊字符

Windows用户平时可能不太敏感，但到了 Linux、容器或者远程开发环境以后，大小写问题会非常明显。

比如：

Config.ts

和：

config.ts

在某些环境里就是两个不同文件。

此外，如果项目路径里存在：

• 中文文件夹；
• 空格；
• 特殊符号；
• 非常深的多层目录；

也建议排查一下。

不是说这些路径一定不能使用，而是当命令执行、脚本调用和工具链组合起来以后，复杂路径更容易增加问题。

七、如果目录没问题，再检查忽略规则

有些项目会通过配置排除部分目录和文件。

例如常见的：

node_modules
dist
build
.env

某些生成目录、大型依赖目录或者敏感配置文件，本身就可能不会作为普通项目代码来处理。

所以如果你发现：

其他文件都能正常读取，偏偏只有某一类文件看不到，

这时候就要检查：

项目配置；

忽略文件；

开发工具配置；

当前环境是否主动排除了这些目录。

这比一直重新启动 Codex 更有意义。

八、一个比较稳定的排查顺序

以后遇到“Codex读不到文件”，可以直接按这个顺序：

第一步：确认当前工作目录。

第二步：确认目标文件真实存在。

第三步：检查相对路径是否正确。

第四步：确认工作区包含目标目录。

第五步：确认当前用户有读取和写入权限。

第六步：检查大小写、特殊路径和忽略规则。

如果前五项都正常，再考虑是不是项目环境或者工具本身的问题。

很多时候并不需要反复重装。

真正的问题只是：

Codex理解的项目位置，和你以为它正在访问的位置，并不是同一个地方。

最后

Codex处理代码的前提，不只是“模型能不能理解代码”。

它首先必须能够：

找到文件 → 读取文件 → 理解目录关系 → 获得修改权限。

所以遇到“文件读取失败”，先不要急着怀疑模型。

先把：

工作目录、文件路径、工作区、权限

这四个基础问题排查清楚。

很多看起来复杂的 Codex 报错，最后其实只是一个路径问题。

---

持续更新 Codex、大模型开发与 AI 编程实战内容，整理 ChatGPT Plus/Pro、AI会员订阅及常见使用问题。更多深度内容，欢迎搜索关注「仙逆GPT」。