新建项目最容易忽略的不是技术选型，而是目录约定和提交规范——它们决定了半年后接手的人要花多久才能改一颗按钮。

先定三条线

  1. 源码与产物分离：src/ 只放会被打包的东西，public/ 放原样拷贝的静态资源。
  2. 样式只有一个入口：src/styles/index.css 统一引入变量与模块，组件里不再各自 import 全局样式。
  3. 提交前必过三关：类型检查、lint、构建，任何一关失败都不允许提交。

目录骨架

src/
├─ styles/    变量、基础样式、模块样式
├─ scripts/   业务逻辑，按页面拆目录
├─ components/复用组件
└─ index.css  唯一的样式入口

目录不是越细越好。三层以内能定位到文件，就是合适的粒度；再深往往说明模块边界没想清楚。

提交规范

用 feat / fix / docs / refactor / chore 五个前缀足够覆盖九成场景。提交信息写清楚「改了什么、为什么改」，比写得多漂亮更重要。

为什么值得

规范本身不产出功能，但它把「理解成本」从每次改动的一次性支出，变成了可以摊薄的固定成本。项目活得越久，这笔账越划算。