新建 Vue3 项目时，把基础设施先搭好，后续开发效率与协作体验差别明显。

一、路径与环境

  • 配置 @ 别名指向 src，避免深层相对路径
  • 按环境拆分 .env 文件，接口地址与开关不写死在代码里

二、请求层

  • 统一封装请求实例，集中处理 token、超时与错误提示
  • 约定响应结构，业务层只处理数据不重复判断状态码

三、状态与路由

  • Pinia 按模块拆分 store，避免单一全局对象膨胀
  • 路由懒加载，权限路由与静态路由分开维护

四、规范与构建

  • ESLint + Prettier 统一风格，提交前自动校验
  • 组件库按需引入，第三方大依赖单独分包

这些配置一次到位，后续新增页面基本只需关注业务本身。