
以下是执行 pnpm create vuetify
生成的典型 Vuetify 项目文件结构及其作用解析(基于默认配置):
MARKDOWN
12345678910111213141516171819202122232425262728293031323334353637383940
.
├── public/ # 静态资源(直接复制到构建结果)
│ └── favicon.ico # 网站图标
│
├── src/ # 核心源码目录
│ ├── assets/ # 静态资源(由构建工具处理)
│ │ └── vuetify.svg # Vuetify 默认 Logo
│ │
│ ├── components/ # 可复用的 Vue 组件
│ │ └── HelloWorld.vue # 示例组件
│ │
│ ├── layouts/ # 页面布局组件
│ │ └── Default.vue # 默认布局(含导航栏/页脚)
│ │
│ ├── plugins/ # Vue/Vuetify 插件配置
│ │ └── vuetify.js # Vuetify 主题/组件配置入口
│ │
│ ├── pages/ # 在此文件夹中创建的VUE组件将自动转换为可导航路由(页面)
│ │ └── index.vue # 首页
│ │
│ ├── router # 路由页面组件
│ │ └── index.ts # 自动路由
│ │
│ ├── stores # Pinia
│ │ ├── app.ts
│ │ └── index.ts
│ │
│ ├── styles # vuetify 样式设置
│ │ └── settings.scss
│ │
│ ├── App.vue # Vue 根组件
│ ├── main.js # 应用入口(初始化 Vue 实例)
│ └── routes.js # 路由配置(若选择启用路由)
│
├── .gitignore # Git 忽略规则
├── index.html # 应用 HTML 入口
├── package.json # 项目依赖和脚本配置
├── pnpm-lock.yaml # 依赖锁文件(pnpm 专用)
├── README.md # 项目说明文档
├── vite.config.js # Vite 构建工具配置
└── .eslintrc.cjs # ESLint 代码规范配置(若选择启用)
关键文件作用说明 Link to 关键文件作用说明
-
vite.config.js
- Vite 构建工具的核心配置,集成 Vuetify 插件、定义开发服务器端口等。
-
src/plugins/vuetify.js
- Vuetify 初始化配置:导入组件/样式、定义主题色、图标库等。
-
src/layouts/Default.vue
- 全局布局模板,通常包含
<v-app-bar>
导航栏和<v-footer>
。
- 全局布局模板,通常包含
-
src/views/*.vue
- 路由页面组件,需通过
routes.js
配置路径映射(若启用路由)。
- 路由页面组件,需通过
-
src/assets/**
- 静态资源(图片/字体),会被 Vite 处理哈希文件名和压缩。
可选功能(取决于创建时的选择) Link to 可选功能(取决于创建时的选择)
src/store/
- Pinia/Vuex 状态管理目录(若启用状态管理)。
tests/
- 单元测试文件(若选择测试框架)。
tsconfig.json
- TypeScript 配置(若选择 TypeScript 模板)。
通过此结构,开发者可以快速开始编写业务组件、配置主题风格或扩展路由功能。