模块 2 · 第 6 节
文件、目录、路径的基本概念
是什么
软件项目就是一堆按结构组织好的文件。理解文件、目录(文件夹)和路径的基本概念,才能看懂项目的结构,也才能准确地告诉 AI 该去改哪个文件。
解决什么问题
如果不理解路径和目录的概念,当 AI 说"修改 src/components/Header.tsx"时你会不知所措,当它在错误的位置创建了文件时你也无法察觉。
项目就是一堆文件
当你在 AI 的帮助下创建一个项目时,你会发现它生成了很多文件。这些文件有的是代码,有的是配置,有的是资源——图片、字体之类的。
所有这些文件不是杂乱无章地堆在一起的,而是按照一定的结构放在不同的文件夹里。这种组织方式,就像一个公司的部门划分——每个部门有自己的办公区域,处理各自负责的事务。
目录:给文件分门别类的容器
在编程的语境里,"文件夹"通常被叫做目录。一个项目的目录结构可能长这样:
my-project/
├── src/
│ ├── components/
│ │ ├── Header.tsx
│ │ └── Footer.tsx
│ └── pages/
│ ├── index.tsx
│ └── about.tsx
├── public/
│ └── logo.png
└── package.jsonsrc 目录下放的是源代码,components 放的是可复用的界面组件,pages 放的是页面文件,public 放的是图片等静态资源,而 package.json 是项目的配置文件。
你不需要记住每种框架的目录约定,但你需要知道:项目是按层次结构组织的,每个文件都有一个明确的"地址"。
路径:文件的地址
路径就是描述一个文件位置的地址。就像邮政地址能让快递员找到你家一样,路径能让程序找到它需要的文件。
路径有两种写法:
绝对路径——从最顶层的起点开始,写出完整的地址。比如 /Users/你的用户名/projects/my-project/src/pages/index.tsx。这就像写"中国某省某市某区某街道某号",不管你站在哪里,这个地址都能唯一确定一个位置。
相对路径——从你当前所在的位置开始描述。比如你现在在 src 目录下,那么 pages/index.tsx 就是相对于你当前位置的路径。这就像有人问你小区超市在哪,你说"出门左转第二个路口"——这个描述只有从你家出发才成立。
在和 AI 交流时,使用路径来指定文件是最准确的方式。"修改 src/pages/index.tsx"远比"修改首页的代码"清晰。
为什么你需要关注这些
当你使用代码编辑器打开一个项目时,左侧通常会显示一棵"目录树"——项目里所有文件和文件夹的层级关系。
花几分钟浏览一下这棵树,对你的帮助比你想象的要大:
- 你能大致知道项目的代码分布在哪些地方。
- 当 AI 说"在
components目录下创建一个新文件"时,你知道它在说什么。 - 当 AI 在不该创建文件的地方创建了文件时,你能察觉到异常。
你不需要理解每个文件的内容,但知道它们的位置和大致用途,就已经让你对项目有了一个可靠的空间感。这种空间感,会在后续的协作中反复帮到你。
指挥与验收
一边讲怎么让 AI 帮你做,一边讲怎么看出 AI 做砸了。
指挥
连接到