Skip to content

Vue 项目结构

当你使用官方脚手架 create-vue 创建一个新项目后,你会得到一个结构清晰的文件夹和文件布局。理解这个结构对于后续的开发至关重要。以下是一个典型 Vue 3 项目的结构解析:

my-vue-app/
├── .vscode/              # VS Code 编辑器相关配置
├── node_modules/         # 存放所有项目依赖的第三方包
├── public/               # 存放不会被打包处理的静态资源
│   └── favicon.ico       # 网站图标
├── src/                  # 项目的核心源代码目录
│   ├── assets/           # 存放会被打包处理的静态资源 (CSS, 图片等)
│   │   └── main.css      # 主要的 CSS 文件
│   ├── components/       # 存放可复用的 Vue 组件
│   │   └── HelloWorld.vue # 一个示例组件
│   ├── App.vue           # 应用的根组件
│   └── main.js           # 应用的入口文件
├── .gitignore            # Git 版本控制的忽略文件列表
├── index.html            # 单页应用的入口 HTML 文件
├── package.json          # 项目元数据和依赖管理文件
├── package-lock.json     # 锁定项目依赖的版本
├── README.md             # 项目的说明文档
└── vite.config.js        # Vite 的配置文件

关键文件和目录详解

  • index.html 这是你的单页应用的“外壳”。它是一个简单的 HTML 文件,包含一个 <div id="app"></div>。整个 Vue 应用最终会被挂载到这个 DOM 元素上。Vite 在构建时会自动将打包后的 CSS 和 JS 文件链接插入到这个文件中。

  • src/ 这是你将花费绝大部分时间工作的目录,包含了应用的所有源代码。

  • src/main.js (或 main.ts) 这是整个应用的入口点。它的主要作用是:

    1. 从 Vue 中导入 createApp 函数。
    2. 导入根组件 App.vue
    3. 创建一个 Vue 应用实例,并将根组件挂载到 index.html 中的 <div id="app"> 元素上。
  • src/App.vue 这是应用的根组件。你可以把它想象成所有其他组件的容器。应用中的页面视图和主要布局都在这个文件中定义。

  • src/components/ 这个目录用于存放所有可复用的子组件。例如,你可以创建一个 Button.vueNavbar.vue 组件,然后在应用的不同地方重复使用它们。组件化是 Vue 开发的核心理念。

  • src/assets/ 这个目录用于存放需要被 Vite 打包处理的静态资源,比如 CSS 文件、Sass 文件、图片等。当你在这里引用一个资源时,Vite 会在构建时对其进行优化处理。

  • public/ 这个目录用于存放那些不需要被打包处理,需要原封不动地复制到构建输出目录根目录下的静态资源。例如,robots.txt 或者一些必须保持特定名称或路径的第三方库文件。

  • package.json Node.js 项目的清单文件。它定义了项目的名称、版本,以及最重要的——项目的依赖 (dependenciesdevDependencies) 和可以运行的脚本 (scripts,如 dev, build)。

  • vite.config.js (或 vite.config.ts) 这是构建工具 Vite 的配置文件。你可以在这里配置插件、定义代理、修改构建选项等。

本站内容仅供学习和研究使用。