React / 系统课时
认识项目目录
认识项目目录
本课建立 Next.js 项目的目录地图。你将知道页面放在哪里、静态资源如何引用、依赖由谁记录,以及哪些生成目录不应手工修改。
学习目标
- 说明顶层目录与配置文件的职责
- 识别 App Router 的特殊文件
- 判断新增代码应放入哪个位置
顶层结构
一个基础 App Router 项目通常包含以下内容:
nextjs-demo/
├── app/
│ ├── favicon.ico
│ ├── globals.css
│ ├── layout.tsx
│ └── page.tsx
├── public/
├── next.config.ts
├── package.json
├── package-lock.json
├── tsconfig.json
└── node_modules/这是结构示例,不是需要执行的命令。启用 src/ 选项时,app 会位于 src/app,其职责不变。
app 目录
app 是 App Router 的核心目录。普通文件夹表示路由片段,page.tsx 让对应路径成为可访问页面,layout.tsx 定义该层级共享的界面外壳。
根目录的 app/page.tsx 对应 /,根目录的 app/layout.tsx 包裹整个应用,并负责输出最外层的 html 与 body。后续还会遇到 loading.tsx、error.tsx 和 not-found.tsx 等特殊文件。
不要把所有组件都堆进 app/page.tsx。页面级入口留在路由目录,可复用组件可以放到 components,数据访问代码可以放到 lib 或按业务领域组织的目录。
public 目录
public 存放可以通过根路径直接访问的静态文件。例如 public/logo.svg 在页面中可以使用 /logo.svg 引用。
这个目录适合图标、静态图片和无需构建处理的文件。私密配置、数据库文件和源代码不能放在这里,因为其中内容可能被浏览器直接访问。
依赖与配置文件
package.json 记录项目名称、脚本和直接依赖,是理解项目运行方式的第一入口。package-lock.json 锁定具体依赖版本,使不同环境安装出尽量一致的依赖树。
tsconfig.json 管理 TypeScript 编译与路径别名。next.config.ts 管理 Next.js 级别的行为,例如图片域名、重写规则或构建选项。修改配置后通常需要重启开发服务器。
可以用下面的命令查看项目脚本:
npm run预期输出:
Scripts available in nextjs-demo:
dev
build
start具体显示格式可能随 npm 与模板版本变化,项目还可能包含代码检查等其他脚本,但应至少能看到开发、构建和生产启动脚本。
生成目录与版本管理
node_modules 保存已安装依赖,体积大且可以通过锁文件重新生成,通常不提交到 Git。.next 在首次运行或构建后生成,包含编译缓存与构建产物,也不应手工编辑。
真正需要维护的是源代码、配置文件、package.json 和锁文件。遇到问题时不要直接修改 .next 中的文件,因为下次构建会覆盖这些改动。
放置文件的判断方法
新增文件前先判断它是否参与路由。参与路由的页面、布局和路由处理器放在 app 对应层级;跨页面复用的组件与工具函数放在独立目录;需要公开访问的静态资源放在 public。
目录组织的目标不是追求固定模板,而是让“路由入口”“共享组件”“服务端逻辑”和“静态资源”边界清楚。