一个项目的样子

打开一个典型的项目，那一长串文件夹清单可能让人觉得像噪音。它不是——大多数项目都遵循一种认得出来的套路。下面是一个精简过的网页应用：

my-app/
├── package.json          # 依赖 + 运行命令（见上文）
├── package-lock.json     # 锁文件 lockfile —— 精确的版本
├── .env                  # 本地的密钥/配置 —— 不要共享
├── .gitignore            # Git 应该忽略的文件（比如 .env）
├── README.md             # 这个项目是什么，怎么运行它
├── public/               # 原样提供的静态文件（图片、图标）
└── src/                  # 你真正的代码住在这里
    ├── components/        # 可复用的 frontend 部件（一个按钮、一张卡片）
    ├── pages/ (or app/)   # 用户导航到的那些界面/路由
    ├── lib/               # 共享的辅助代码和 backend 逻辑
    └── styles/            # CSS

你不用把这个背下来——只要认得出来就行，这样当 AI 说 "我会把这个加到 src/lib 里" 时，你大致知道那是在哪里、为什么在那里。有几条起承重作用的约定：

• src/ 装着你写的代码。最顶层那些杂乱的东西基本上都是配置。
• 根目录下的配置文件（那个 package.json、那些点开头的文件）配置的是工具，而不是你应用的行为。
• .gitignore 列出那些不应该被存进版本控制的文件——你的 .env 就属于这里，而这正是密钥得以不进入共享仓库的办法。