VUE3+TS+element-plus项目从0开始入门 - 创建项目、认识基本结构

写在前面

开前请自行下载vs code、node.js, 在vs code里面安装Vue - Official插件。本文使用的是vue3、ts、element,windows系统。

本文是 VUE3+TS+element-plus项目从0开始入门 系列的第一章
下一章 : VUE3+TS+element-plus项目从0开始入门 - 02

1、创建vue3项目

打开vscode,选择一个你希望项目保存的位置
在这里插入图片描述
再打开vs code的终端
在这里插入图片描述

npm create vue@latest

输入npm指令 npm create vue@latest , 后面依次按要求输入就行
这里Vue Router、和ESLint我们都选了了否,是为了更方法的入门vue3项目,在实际的工程中一般选是。
在这里插入图片描述

npm i

输入npm i 安装项目依赖

注意这里要先切换到项目的根目录下
npm i 是npm install的简写

在这里插入图片描述
npm i 执行完成之后会多一个项目依赖目录
在这里插入图片描述

2、项目结构

.vscode

.vscode 里面主要放vscode的工程配置文件。

.vscode里面的内容修改之后,关闭vscode再重新打开一下才会显示效果
在这里插入图片描述

vue3结构

a、项目树结构

这里面主要关注src, 后续前端写的大多数内容都在里面

├─node_modules                  # 存放项目依赖
├─public
│      favicon.ico              # 网站图标,浏览器标签栏显示的小图标
└─src
    │  App.vue                  # 根组件,Vue顶级组件,其他组件通常嵌套在其中
    │  main.ts                  # 应用入口文件,初始化Vue实例并挂载到DOM上
    │  
    ├─assets
    │      base.css             # 基础样式文件,定义全局通用样式
    │      logo.svg             # 项目Logo的SVG文件,通常用于品牌展示
    │      main.css             # 主样式文件,可能包含项目的主要CSS规则
    │      
    └─components
        │  HelloWorld.vue       # 示例组件,通常用于演示或测试目的
│  .gitignore                   # Git忽略规则文件
│  env.d.ts                     # TS类型声明文件,若没有,import时会报错
│  index.html                   # 项目HTML入口,Vue会被挂载到此文件中
│  package-lock.json            # 记录npm安装的依赖版本信息,确保不同环境中依赖一致性
│  package.json                 # 项目配置文件,包含项目基本信息、依赖和脚本命令
│  README.md                    # 项目的说明文档,通常包含项目介绍、使用方法等内容
│  tsconfig.app.json            # TypeScript配置文件,专门针对应用程序代码的TS编译选项
│  tsconfig.json                # 主要的TypeScript配置文件,定义了整个项目的TS编译规则
│  tsconfig.node.json           # TypeScript配置文件,专门针对Node.js环境的代码编译选项
│  vite.config.ts               # Vite构建工具的配置文件,用于自定义构建行为

b、package.json

项目中有package-lock.json和package.json

  • package-lock.json通常不需要手动编辑
    每次运行 npm install 或其他相关命令时,npm 会根据 package.jso

使用 `Vite` + `Vue 3` + `TypeScript` + `Element Plus` 初始化一个前端项目是一个非常现代且高效的开发组合。下面我将一步步带你完成项目的初始化,并提供完整代码和解释。 --- ### ✅ 步骤一:使用 Vite 创建 Vue + TypeScript 项目 打开终端,运行以下命令: ```bash npm create vite@latest my-vue-element-plus-app -- --template vue-ts ``` > 这会创建一个名为 `my-vue-element-plus-app` 的项目,使用 Vue 3 + TypeScript 模板。 进入项目目录: ```bash cd my-vue-element-plus-app ``` 安装依赖: ```bash npm install ``` --- ### ✅ 步骤二:安装 Element Plus Element PlusVue 3 官方推荐的 UI 组件库。 ```bash npm install element-plus @element-plus/icons-vue ``` --- ### ✅ 步骤三:全局引入 Element Plus(完整引入) 编辑 `src/main.ts` 文件: ```ts // src/main.ts import { createApp } from &#39;vue&#39; import App from &#39;./App.vue&#39; // 引入 Element Plus 及其样式 import ElementPlus from &#39;element-plus&#39; import &#39;element-plus/dist/index.css&#39; // 可选:中文语言包(如果需要) import zhCn from &#39;element-plus/es/locale/lang/zh-cn&#39; const app = createApp(App) // 使用 Element Plus app.use(ElementPlus, { locale: zhCn }) app.mount(&#39;#app&#39;) ``` --- ### ✅ 步骤四:在组件中使用 Element Plus 组件 修改 `src/App.vue` 示例内容: ```vue <template> <div class="app-container"> <el-config-provider :locale="zhCn"> <el-button type="primary" @click="handleClick">主要按钮</el-button> <el-button type="success">成功按钮</el-button> <el-input v-model="inputValue" placeholder="请输入内容" style="width: 200px; margin-left: 10px;" /> <el-icon style="margin-left: 10px;"><Edit /></el-icon> </el-config-provider> </div> </template> <script setup lang="ts"> import { ref } from &#39;vue&#39; import { Edit } from &#39;@element-plus/icons-vue&#39; import zhCn from &#39;element-plus/es/locale/lang/zh-cn&#39; const inputValue = ref(&#39;&#39;) const handleClick = () => { alert(&#39;Hello from Element Plus!&#39;) } </script> <style scoped> .app-container { padding: 20px; font-family: Arial, sans-serif; } </style> ``` --- ### ✅ 步骤五:启动项目 ```bash npm run dev ``` 访问 `http://localhost:5173` 即可看到 Element Plus 的按钮、输入框等组件正常显示。 --- ### 🔍 解释说明 - **Vite**:极速构建工具,利用浏览器原生 ES Modules 提供闪电般启动速度。 - **Vue 3 + `<script setup>`**:组合式 API,更简洁的语法糖。 - **TypeScript**:提供类型检查,增强代码健壮性。 - **Element Plus**: - `element-plus/dist/index.css`:必须引入的样式文件。 - 图标需单独从 `@element-plus/icons-vue` 导入并注册。 - 使用 `<el-config-provider>` 可统一配置国际化(如中文)。 --- ### 🚀 可选优化:按需导入(减少打包体积) 如果你不想全量引入 Element Plus,可以使用插件实现按需加载: #### 安装插件: ```bash npm install -D unplugin-vue-components unplugin-auto-import ``` #### 配置 `vite.config.ts`: ```ts // vite.config.ts import { defineConfig } from &#39;vite&#39; import vue from &#39;@vitejs/plugin-vue&#39; import AutoImport from &#39;unplugin-auto-import/vite&#39; import Components from &#39;unplugin-vue-components/vite&#39; import { ElementPlusResolver } from &#39;unplugin-vue-components/resolvers&#39; export default defineConfig({ plugins: [ vue(), AutoImport({ resolvers: [ElementPlusResolver()], }), Components({ resolvers: [ElementPlusResolver()], }), ], }) ``` 这样你就可以无需手动导入组件和图标,它们会在使用时自动注册。 --- ### ✅ 最终项目结构概览 ``` my-vue-element-plus-app/ ├── src/ │ ├── main.ts │ ├── App.vue │ └── components/ ├── vite.config.ts ├── tsconfig.json ├── package.json └── index.html ``` --- ###
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值