T-ui-plus 框架搭建与配置教程

1. 项目目录结构及介绍

在 t-ui-plus 开源项目中，典型的目录结构可能会如下所示：

├── src
│   ├── assets           # 资源文件夹，存放静态资源
│   ├── components       # 自定义组件文件夹
│   ├── directives       # 指令文件夹
│   ├── icons            # 图标文件夹
│   ├── layouts          # 布局文件夹
│   ├── pages             # 页面文件夹
│   ├── plugins          # 插件文件夹
│   ├── router            # 路由文件夹
│   ├── store             # Vuex状态管理
│   ├── styles            # 样式文件夹
│   └── views             # 视图文件夹
└── public                # 静态公共文件夹，如 favicon 等

这个目录结构反映了常见的 Vue3 项目组织方式，包括组件、路由、样式和状态管理等核心部分。

2. 项目的启动文件介绍

启动文件通常位于 src/main.js 文件。在这个文件中，你需要进行以下关键步骤来初始化你的应用：

import { createApp } from 'vue'
import App from './App.vue'
import ElementPlus from 'element-plus'
import '@element-plus/dist/index.css'
// ...其他导入

// 创建并挂载应用
const app = createApp(App)

// 注册 ElementPlus 和 T-ui-plus 组件
app.use(ElementPlus)
app.use(TuiPlus)

// 设置语言和尺寸
// app.use(locale)    // 对应语言包
// app.config.globalProperties.$ELEMENT.size = 'medium'  // 设定全局大小

// 全局注册组件和图标
// ...根据需要注册组件和图标

// 挂载到 DOM
app.mount('#app')

App.vue 是你的应用程序入口组件，createApp 用于创建 Vue 应用实例，而 use 方法用于注入和使用各种库和自定义功能。

3. 项目的配置文件介绍

在 Vue 3 项目中，配置文件主要存在于 vue.config.js 或者 vite.config.js （取决于你使用的构建工具）。这个文件允许你自定义构建过程中的各种参数，例如：

module.exports = {
  publicPath: '/',
  outputDir: 'dist',
  runtimeCompiler: true,
  productionSourceMap: false,
  configureWebpack: config => {
    if (process.env.NODE_ENV === 'production') {
      // 生产环境的配置
    } else {
      // 开发环境的配置
    }
  },
  lintOnSave: process.env.NODE_ENV !== 'production',
  devServer: {
    port: 8080,
    proxy: {
      '/api': {
        target: 'http://localhost:3000', // 服务器接口地址
        changeOrigin: true,
        pathRewrite: {
          '^/api': ''
        }
      }
    }
  }
}

上述配置中，publicPath 通常是部署路径，outputDir 指定生成文件的位置，lintOnSave 控制是否开启代码检查。devServer 选项则用于配置本地开发服务器，包括端口号 (port) 和代理 (proxy)，以便于在开发过程中连接后端API。

请注意，具体的配置可能因项目需求有所不同，你可以根据实际情况调整这些参数。如果你使用的是 Vite，那么配置文件可能包含不同的选项或语法，因为它是基于 Rollup 构建的。