Deft UI 项目启动与配置教程

1. 项目目录结构及介绍

Deft UI 是一个开源的前端项目，其目录结构如下：

deft/
├── .gitignore        # 定义哪些文件应该被 Git 忽略
├── .npmrc            # npm 配置文件
├── README.md         # 项目说明文件
├── package.json      # 定义项目依赖和脚本
├── package-lock.json # npm 依赖锁文件
├── src/              # 源代码目录
│   ├── assets/       # 静态资源目录，如图片、样式表等
│   ├── components/   # 通用组件目录
│   ├── pages/        # 页面组件目录
│   ├── store/        # 状态管理目录
│   ├── utils/        # 工具函数目录
│   └── App.vue       # 根组件
├── public/           # 公共文件目录
│   └── index.html    # 页面入口 HTML 文件
└── vue.config.js     # Vue 配置文件

• .gitignore：指定在版本控制过程中应该忽略的文件和目录。
• .npmrc：存储npm配置信息，如registry源。
• README.md：项目的基本介绍和说明。
• package.json：定义了项目的依赖、脚本和元数据。
• package-lock.json：锁定项目的依赖版本，确保在不同环境中构建的一致性。
• src/：源代码目录，包含了组件、页面、工具函数等。
• public/：存放不会被Webpack处理的静态文件。
• vue.config.js：Vue CLI项目的可选配置文件。

2. 项目的启动文件介绍

项目的启动主要通过package.json中的scripts字段定义的脚本完成。以下是一个基本的启动脚本示例：

"scripts": {
  "serve": "vue-cli-service serve",
  "build": "vue-cli-service build",
  "test": "vue-cli-service test",
  "lint": "vue-cli-service lint"
}

• "serve"：启动开发服务器。这个脚本会调用vue-cli-service serve命令，启动一个本地服务器用于开发和测试。
• "build"：构建生产环境的代码。这个脚本会调用vue-cli-service build命令，生成优化后的应用代码，用于生产部署。
• "test"：运行单元测试。
• "lint"：运行代码格式化工具。

要启动项目，可以在项目根目录下运行以下命令：

npm run serve

这会启动一个热重载的本地开发服务器。

3. 项目的配置文件介绍

项目的配置主要通过vue.config.js文件进行。以下是vue.config.js的一个基础配置示例：

module.exports = {
  // 基本路径
  publicPath: '/',
  // 构建时的输出目录
  outputDir: 'dist',
  // 放置静态资源的目录
  assetsDir: 'static',
  // html的输出路径
  indexPath: 'index.html',
  // 文件名哈希
  filenameHashing: true,
  // eslint-loader 是否在保存的时候检查
  lintOnSave: process.env.NODE_ENV !== 'production',
  // 是否使用包含运行时编译器的Vue核心的构建
  runtimeCompiler: false,
  // 默认情况下 babel-loader 忽略其中的所有文件 node_modules
  transpileDependencies: [],
  // 生产环境 sourceMap
  productionSourceMap: false,
  // 跨域设置
  devServer: {
    open: process.platform === 'darwin',
    host: '0.0.0.0',
    port: 8080,
    https: false,
    hotOnly: false,
    proxy: null // 设置代理
  }
}

这个文件包含了项目的公共配置，例如输出目录、静态资源目录、开发服务器配置等。开发者可以根据自己的需求对配置进行修改。