首页 前端知识 【V3 Admin Vite】教程一:环境、下载、运行项目

【V3 Admin Vite】教程一:环境、下载、运行项目

2024-08-04 22:08:42 前端知识 前端哥 973 554 我要收藏

前言

本系列文章是为了帮助没有直接上手(或上手比较困难)做项目能力的初级前端开发工程师采用 V3 Admin Vite 开源模板来编写业务代码。

如果你是一个有经验的朋友,那建议你直接阅读文档即可:V3 Admin Vite 中文文档,因为本系列教程节奏偏慢。

本系列文章的同步视频教程版本地址:B 站(群友好心录制)

文章目的

本文将手摸手带你把前端开发需要的环境从零配置好,并下载 V3 Admin Vite 在本地运行起来。

Begin

配置本地开发环境

Node

去 node 官网下载并安装 node 环境:Node.js — 在任何地方运行 JavaScript ,一般选择最新的 LTS (长期维护)版本即可(在编写本文时,我的电脑是用的 16.17.0 版本)。

安装完成后,打开你电脑的命令行窗口,输入命令:node -v,即可查看并确认刚刚安装的 node 版本。

建议版本:16+

Npm

下载并安装好 node 之后,就会自动携带 npm 了,所以你什么都不用管,直接运行命令查看自己本地的 npm 版本即可:npm -v

建议版本:node 版本不低于 16 即可

Pnpm

由于 V3 Admin Vite 是推荐使用 pnpm 命令来安装第三方依赖,而不是直接使用 npm 命令。所以这边要提前将 pnpm 安装好。官网安装方法:安装 | pnpm (选择其中一种即可,我这边一般是直接通过 npm 命令来安装)


npm install -g pnpm

安装后同样也是使用 -v 命令来查看版本

如果你安装后,运行 pnpm 会报错,那么你可以复制你的报错信息去网上找一下相应的答案(可能会涉及到手动重新配置 pnpm 的环境变量)

建议版本:7+

IDE

推荐免费的 Visual Studio Code,当然收费的 WebStorm 也行。

建议版本:最新版

Git

直接官网下载安装最新版即可:https://git-scm.com/downloads

建议版本:最新版

下载源码

从 GitHub 上克隆

前文已经安装好了 Git 命令,所以我们这时候直接打开命令行窗口(可以先自行规划好目录),复制以下命令即可克隆源码到当前目录下了


git clone https://github.com/un-pany/v3-admin-vite.git

从 Gitee 上克隆

假如你的网络不支持从 GitHub 上克隆源码的时候,可以选择使用国内的 Gitee


git clone https://gitee.com/un-pany/v3-admin-vite.git

运行项目

打开项目

打开 VSCode 后,依次点击左上角 File(文件)、Open Folder(打开文件夹),选择刚才克隆下载的源码文件夹即可。

或者你直接将文件夹拖拽到 VSCode 桌面图标处就也能自动打开。

安装推荐插件

项目根目录下有一个 .vscode 文件夹,它是专属这个项目的 vscode 配置。其中 extensions.json 文件是用来配置本项目推荐的插件:

一键安装上图中推荐的插件,只需要如下图操作即可:

安装完成后可能会提示你重启 vscode,照做即可。

注意:Vue3 项目对应的是 Volar 插件,记得禁用 Vue2 的 Vetur 插件!

安装依赖

依次点击 vscode 顶部的 Terminal(终端)、New Terminal(新建终端),在底部弹出的命令行窗口中输入命令:


pnpm i

等待安装完成即可。

如果你实在是觉得安装太慢不能忍,可以选择将官方依赖源切换为淘宝依赖源:


npm config set registry https://registry.npmmirror.com

切换源或者依赖失败之后,如果你要选择重新安装依赖,你需要将之前已经安装的 node_modules 文件夹和 pnpm-lock.yaml 文件删除了,再次运行安装 pnpm i 命令

运行

继续在 vscode 自带的命令行窗口输入命令:


pnpm dev

等待大约 1.5s 后,如下图所示代表运行成功!

在现代浏览器(比如 Chrome)中访问图中的链接:

End

本系列所有手摸手教程

  • 掘金专栏(文字版)

  • B 站(视频版)

V3 Admin Vite 相关链接

  • 中文文档

  • GitHub

  • Gitee

转载请注明出处或者链接地址:https://www.qianduange.cn//article/14776.html
标签
github
评论
发布的文章

RapidJSON介绍

2024-08-14 00:08:38

jQuery 4 beta 震撼发布

2024-08-14 00:08:36

cJSON的使用

2024-08-14 00:08:36

大家推荐的文章
会员中心 联系我 留言建议 回顶部
复制成功!