Codex 无法读取项目怎么判断
很多用户会把下面这些现象都统称成一句话：
Codex 读不到我的项目但这句话背后，可能是完全不同的几类问题：
- 你开错目录了
- 当前目录不是项目根目录
- 目录里缺关键文件
- 当前权限不允许它读
- 你以为它在看整个仓库，其实它只在看一个子目录
所以第一步不是继续追问“你怎么这么笨”，而是先把“它到底看到了什么”搞清楚。
前置教程：第一次让 Codex 阅读项目
如果你还没有走过一次标准的“只读分析项目”流程，先完成前置教程。
依据来源：OpenAI Codex 官方手册中关于 working directory、workspace、sandbox、read-only analysis、local environments、troubleshooting 的说明。
学完后，你应该能做到：
- 判断 Codex 是真的读不到，还是读偏了。
- 知道项目根目录为什么很重要。
- 知道如何让 Codex 先汇报它当前看到的工作区。
- 知道什么时候是权限问题，什么时候是目录问题。
- 知道怎么把“读不到项目”拆成可排查的小问题。
先区分两种情况
Section titled “先区分两种情况”“无法读取项目”通常分成两大类：
1. 它能读文件，但读错了范围
Section titled “1. 它能读文件，但读错了范围”典型现象：
- 它找不到前端入口
- 它说项目里没有
package.json - 它只看到一个子目录
- 它分析结果明显不像你的真实项目
这类大多不是“完全读不到”，而是：
它看的不是你以为的那个目录2. 它连正常读文件都做不到
Section titled “2. 它连正常读文件都做不到”典型现象：
- 明确提示无权限
- 明确提示 workspace 外不可访问
- 明确提示目录不存在
- 你让它看文件，它连最基础的目录列表都拿不到
这类才更像是真正的读取失败。
第一步：先让 Codex 说清楚它当前看到什么
Section titled “第一步：先让 Codex 说清楚它当前看到什么”以后只要你怀疑它读错项目，先发这段：
请先不要修改文件。
请只读告诉我你当前看到的工作区信息：1. 你当前工作的根目录是什么。2. 你当前能看到哪些顶层文件和目录。3. 你是否看到了 package.json、pom.xml、.git、src、app、pages 等关键文件或目录。4. 你判断这更像什么类型的项目。5. 如果你觉得当前目录不是项目根目录，请明确说明依据。这一步非常关键，因为很多误会到这里就能拆开。
第一步你期待看到什么
Section titled “第一步你期待看到什么”一个靠谱的回复通常会告诉你：
- 当前工作目录路径
- 顶层目录列表
- 它识别到的关键文件
- 它推断的技术栈
如果它连这些都说不清，那就不要继续让它分析业务。
最常见原因 1：你开错目录了
Section titled “最常见原因 1：你开错目录了”这是第一高频原因。
例如你的真实项目根目录是：
D:\project\my-app但你实际让 Codex 进入的是：
D:\project或者：
D:\project\my-app\src这时它当然会读偏。
所以只要它说：
- 看不到
package.json - 看不到
.git - 看不到主目录结构
第一反应先怀疑目录，不要先怀疑模型。
最常见原因 2：你开的只是仓库子目录
Section titled “最常见原因 2：你开的只是仓库子目录”这在 monorepo、多模块项目里特别常见。
例如：
- 你打开的是某个模块
- 但你要求它分析整个仓库
这时它并不是不会，而是它真的只被允许看到这一块。
正确做法是先问：
你当前看到的是整个仓库，还是其中一个子模块？请根据顶层结构判断，并说明依据。最常见原因 3：关键文件没在当前目录
Section titled “最常见原因 3：关键文件没在当前目录”Codex 判断项目类型，通常会看这些信号：
package.jsonpom.xml.gitsrcapppagesREADME.md
如果这些关键文件不在当前目录，它很容易判断偏。
所以当它说“看起来不像前端项目”“没看到构建脚本”时，先看是不是目录层级不对。
最常见原因 4：权限或工作区边界
Section titled “最常见原因 4：权限或工作区边界”官方手册反复强调，Codex 在本地通常只能访问当前工作区，超出工作区范围会被拦住。
所以如果你的现象更像：
- 它能看 A 目录
- 但看不到上一级或旁边目录
那要怀疑的是：
工作区边界而不是“文件神秘消失了”。
最常见原因 5：项目文件不完整
Section titled “最常见原因 5：项目文件不完整”还有一种情况是：
- 你本地项目本来就没装依赖
- 某些目录还没拉完整
- 忽略文件太多
- 工作树环境不完整
这类情况下，Codex 不是“读不到”，而是它看到的项目本来就不完整。
所以它分析时可能会说：
- 缺少依赖
- 找不到构建脚本
- 某些目录不存在
这时候不要强行让它继续推断一大堆业务逻辑。
一段很实用的排查提示词
Section titled “一段很实用的排查提示词”我怀疑你现在没有正确读到我的项目。
请先只读排查，不要修改文件：1. 先告诉我你当前工作的根目录。2. 列出你当前能看到的顶层文件和目录。3. 判断当前目录是不是项目根目录。4. 如果不是，请说明你为什么这样判断。5. 如果你看不到我预期中的关键文件，请告诉我更像是目录问题、权限问题，还是项目本身不完整。不要一上来就做的事
Section titled “不要一上来就做的事”下面这些都不应该是第一反应：
- 直接重装 Codex
- 直接换模型
- 直接删目录重拉
- 直接让它“自己猜”
- 继续给它更复杂的业务任务
先搞清它看到的是不是正确工作区，才是正路。
什么时候可以继续往下做任务
Section titled “什么时候可以继续往下做任务”当你已经确认：
- 当前目录是对的。
- 它能看到关键文件。
- 它的项目类型判断基本正确。
- 没有明显的权限拦截。
这时候再让它：
- 找前端入口
- 找后端入口
- 分析构建方式
- 修改代码
就会稳很多。
做到这里，如果你已经能先判断下面几类情况，就说明本篇目的达到了：
- 是开错目录。
- 是开到了子目录。
- 是关键文件不在当前层级。
- 是工作区权限边界。
- 是项目本身不完整。
下一篇看什么
Section titled “下一篇看什么”下一篇建议看：端口被占用怎么处理
这个问题在本地跑项目、预览页面和反复启动开发服务时特别高频。