简介

vue3-pc-tmp 基于 Vue3.x setup + TypeScript + Vite + Pinia + naiveui + sass + unocss + axios（封装）+ Eslint + Prettier + dayjs 等流行技术栈构建 PC 端模板脚手架，开箱即用。

支持的平台

浏览器

不支持 IE 浏览器。

Edge、Firefox、Chrome、Safari 等现代浏览器的最新的 2 个版本确保会被支持。

对于这些浏览器的其他版本中，由于开发资源的限制并没有做过严格的测试。但是我预期 vue3-pc-tmp 应该在这些浏览器不算太老的版本上能正常的运行（比如 2 年之内的版本）。如果你发现了任何问题欢迎来提 issue。

技术规范

环境要求

• node >14
• pnpm >=7
• 支持现代浏览器以及 Chrome >= 51、iOS >= 10.0（与 Vue 3 一致）。

编辑器以及对应扩展

• Visual Studio v69+
• Vetur v0.35.0+
• Eslint v2.2.6+
• Prettier - Code formatter v9.5.0+
• UnoCSS v0.47.6+

快速开发

#通过 npm 安装 pnpm (如果本地已安装pnpm,请忽略)
npm install -g pnpm
#安装项目依赖
pnpm install
#开发环境启动
pnpm start
#打包 test 环境代码
pnpm build:test
#打包生产环境代码
pnpm build or pnpm build:prod
#执行 js 类型检查
pnpm lint:fix
#执行 prettier 批量格式化代码
pnpm lint:prettier
#执行 ts 语法错误检查
pnpm lint:type

##注：详细请阅读package.json 以及对应的环境配置文件（即.env 文件）！

同时在项目根目录下包含一个 run.bat，该文件会列出所有 package.json 中 script 块里面的所有命令，
通过双击该文件，你可以在命令行中输入相应的序号并按 Enter 键，程序将运行你选择的脚本。

开发基础规范

• 🚀 重要、复杂逻辑一定要写注释；
• 🚀 代码规范按照 eslint 的规则来，做到 no waring 和 no error；
• 🚀 项目业务开发，优先使用 vue 全家桶技术栈开发项目，预编译使用 sass；
• 🚀 操作成功或失败后要有提示，比如新增成功、新增失败运行时间长的任务（计算量大、请求后台接口），要有 loadding 效果；
• 🚀 vue 单文件组件代码规范，html、script、style 的位置顺序 html > script > style；
• 🚀 公共的状态才放到 store；
• 🚀 代码尽量往纵向发展，一行不要太长；
• 🚀 不要在钩子函数中写大量业务代码；
• 🚀 异步使用 aysnc await 语法；
• 🚀 不是常用的方法不要全局挂载；
• 🚀 文件命名如果是多单词则采用驼峰命名或者烤肉串大小写，尽量简洁明了；

基础组件名。 【注：src/resources/components 目录。】

基础组件文件命名应该以 base 为前缀命名，以示其唯一性，并且以横线连接。

例子：
src
└─ resources
   └─ components
      └─ base-button
         ├─ index.vue      //源码
         └─ README.md      //组件使用说明文档

业务组件名。 【注：src/views/components 目录。】

业务组件文件命名应该以 the 为前缀命名，以示其唯一性，并且以横线连接。

例子：
src
└─ views
   └─ components
      └─ the-button
         ├─ index.vue      //源码
         └─ README.md      //组件使用说明文档

路由文件创建与命名。 【注：src/config/router 目录。】

为了方便维护与开发，建议路由文件命名与对应的页面文件命名保持一致，尽量简洁明了。

例子：
src
└─ config
   └─ router
      ├─ dev.ts
      ├─ errpage.ts
      └─ index.ts

接口文件创建与命名。 【注：src/config/apis 目录。】

为了方便维护与开发，建议接口文件命名与对应的页面文件命名保持一致，尽量简洁明了。

例子：
src
└─ config
   └─ apis
       └─ dev

状态切片文件创建与命名。 【注：src/config/store 目录。】

为了方便维护与开发，建议以当前对应模块或者功能命名文件夹，采用驼峰命名或者烤肉串大小写，尽量简洁明了。

例子：
src
└─ config
   └─ store
      └─ dev

图片资源。 【注：src/assets/img 目录。】

建议图片文件夹命名与对应的页面文件命名保持一致，公共图片资源放置到 src/assets/img/base 目录下即可。

例子：
src
└─ assets
   └─ img
      └─ base

git 版本规范

分支管理

一般项目分主分支（master）和其他分支。 当有团队成员要开发新功能(Feather)或改 BUG(Fix) 时，就从 master 分支开一个新的分支。

Commit 规范

• feat 新增功能
• fix 修复 bug
• docs 文档变更
• style 代码格式（不影响功能，例如空格、分号等格式修正）
• refactor 代码重构
• perf 改善性能
• test 测试
• build 变更项目构建或外部依赖（例如 scopes: webpack、gulp、npm 等）
• ci 更改持续集成软件的配置文件和 package 中的 scripts 命令，例如 scopes: Travis, Circle 等
• chore 变更构建流程或辅助工具
• revert 代码回退

Tag 版本号

版本号以 v 开头，根据当前仓库的 tag 编号进行累加，如：v1.10.45。

项目目录说明

vue3-pc-tmp
├─ .env.development                      // 开发环境配置
├─ .env.production                       // 生产环境配置
├─ .env.test                             // 测试环境配置
├─ .eslintignore                         // ESLint配置，用于忽略特定文件
├─ .eslintrc-auto-import.json            // 自动导入的ESLint配置
├─ .eslintrc.cjs                         // 使用CommonJS格式的ESLint配置
├─ .npmrc                                // NPM配置文件
├─ .prettierrc.js                        // Prettier配置文件
├─ .vscode                               // VSCode编辑器配置
├─ env.d.ts                              // 用于环境变量的TypeScript声明文件
├─ index.html                            // 主HTML文件
├─ package.json                          // Node.js包配置
├─ pnpm-lock.yaml                        // pnpm包管理器的锁文件
├─ public                                // 存放静态资源的公共目录
├─ README.md                             // 项目文档
├─ run.bat                               // 运行脚本的批处理文件
├─ src                                   // 源代码目录
│  ├─ App.vue                            // 主组件
│  ├─ assets                             // 资源文件（图片、样式等）
│  ├─ config                             // 配置文件
│  │  ├─ router                          // 路由配置
│  │  └─ store                           // Vuex状态管理配置
│  ├─ layout                             // 布局组件
│  ├─ main.ts                            // 应用入口点
│  ├─ packages                           // 自定义包或模块
│  │  ├─ request                         // 处理API请求的模块
│  │  └─ router                          // 自定义路由模块
│  ├─ resources                          // 项目额外资源
│  │  ├─ components                      // 可复用组件
│  │  └─ plugin                          // Vue插件
│  ├─ types                              // TypeScript类型定义
│  ├─ utils                              // 工具函数
│  └─ views                              // 视图的Vue组件
├─ tsconfig.app.json                     // 应用的TypeScript配置
├─ tsconfig.config.json                  // TypeScript配置文件
├─ tsconfig.json                         // TypeScript基本配置
├─ tsconfig.vitest.json                  // Vite测试的TypeScript配置
├─ unocss.config.js                      // UnoCSS的配置
└─ vite.config.ts                        // Vite配置文件