模块 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.json

src 目录下放的是源代码,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 做砸了。

指挥怎么让 AI 帮你做

指挥

在让 AI 修改代码时,用准确的文件路径指定要改的位置——"修改 src/components/Header.tsx 中的导航部分"比"修改导航栏的代码"精确得多。

连接到