src

可以先理解为:存放源代码的项目目录

src 像工作台。真正要被编译、打包和运行的代码通常放在这里,而说明书、配置、报告和构建产物放在别处。这样项目一打开,开发者知道该去哪里找实现。

关键结构图

这一层

打开

下一层

继续

停下

项目根目录下有 src、data、docs、scripts,src 里面再分 app、components、lib、styles。

src 是项目里存放主要源代码的目录,把实现代码和配置、文档、构建产物区分开。

src 是 source 的常见缩写,在许多软件项目中作为主要源代码目录。它可以包含 app、components、lib、styles、tests 等子目录。它的边界是组织源码,不是强制标准;有些项目也会把源码放在根目录或其他结构里。

Structuresrc = 源代码入口 + 模块分层 + 构建输入 + 项目边界

当项目开始有多个页面、组件、工具函数、样式和数据模块时,用 src 组织源码会更容易维护。

把运行时代码放进 src,再按 app、components、lib、styles 或 domain 模块分层。生成物、报告和私有数据不要混进源码目录。

Next.js 项目可以用 src/app 放路由,src/components 放组件,src/lib 放数据和工具函数。

如果把脚本输出、临时报表和页面组件都混在一个目录里,AI 和人都更容易改错文件。

类型:工程约定 / 项目结构

事实线:许多前端和后端项目使用 src 目录组织应用源代码,让源码与配置、文档和输出目录分开。

依据:JavaScript/TypeScript 项目实践、Next.js 和前端工程目录组织习惯。

边界:适合中大型项目或希望目录清晰的项目;小脚本项目可以更简单。

常见误读:不要以为有 src 就代表架构清楚。真正重要的是目录内模块边界是否清楚。