Vue3 + Vue Cli 搭建项目(详细)
搭建:Vue CLI 5 + Vue 3 + Ant Design Vue 3
- Vue CLI 5:是vue + 大量的第三方组件;
- Vue 3:是页面开发基于Vue;
- Ant Design Vue 3:是基于Vue3的UI组件;关于UI还有CSS的Bootstrap。
1. 本地环境准备
按照NodeJS得到npm,使用npm安装 vue cli(脚手架),使用vue cli创建项目。
Vue CLI 5 需要安装 Nodejs 18及以上。
NodeJS官网:https://nodejs.org/zh-cn/
Vue CLI 官方文档:https://cli.vuejs.org/zh/guide/
1) Node18安装
目前使用最多的是14,16,18,20。已经下载过有不同版本的直接修改配置就好了。
下载好后点击安装,设置好路径后直接 next 下一步,不需要选任何东西。
到这里也不需要勾选。
install -> finish完成。
Win + R -> cmd 窗口查看一下版本。
# node 版本 node -v # npm 版本 npm -v
出现版本号正常,则成功。
npm 属于 nodejs 内的工具,安装完 node 后 npm 会带上,无需额外单独安装。
2) 配置环境
计算机属性 -> 高级系统设置 -> 环境变量 -> Path
由于 node 使用 npm 命令安装时默认在 C盘,node后期安装插件等占据内存很大,所以很不建议默认路径在C盘。
手动设置改变路径,设置nodejs prefix(全局)与 cache(缓存)路径。
nodejs安装目录下新建文件夹:node_global 和 node_cache
# 查看 prefix 全局
npm get prefix
# 查看 cache 缓存
npm get cache
查出来是在C盘的路径下。
# 修改 prefix npm config set prefix "安装路径\node_global" # 修改 cache npm config set cache "安装路径\node_cache"
3) 设置淘宝镜像及淘宝cnpm
# 下载镜像源 # 查看镜像源 npm config get registry # 配置 npm config set registry https://registry.npmmirror.com/ npm config set registry https://registry.npm.taobao.org/
完成后再次查看一下镜像源。
# 安装cnpm # 配置一 npm install -g cnpm --registry=https://registry.npm.taobao.org # 配置二 npm install -g cnpm --registry=https://registry.npmmirror.com
配置一和二都是淘宝提供的 npm 镜像源。
配置一用于加速npm包的下载,但已被配置二 npmmirror服务 取代。
配置二是新的 npm镜像源,更好的服务稳定性和更新速度。推荐使用配置二。
# 查看
cnpm -v
若是安装完 cnpm 或 执行 cnpm命令 出现 [不是内部或外部命令,也不是可运行的程序]。把当前终端窗口关闭 重新 cmd 打开重新安装。
注意:如果在 2)配置环境 或 安装cnpm 时出现错误说:关于权限。需要将安装的nodejs路径的包提权。右键 -> 属性 -> 安全 / 编辑 对 Authenticated ... 的权限。
4) 设置用户变量
计算机属性 -> 高级系统设置 -> 环境变量 -> 用户变量 -> Path 添加 node_global 安装全路径。
计算机属性 -> 高级系统设置 -> 环境变量 -> 系统变量 -> 新建:
Path 新建环境变量添加路径。
5) 安装 vue cli
# vue2 脚手架命令 nmp install -g # vue3 脚手架命令(默认最新) npm install -g @vue/cli # vue3 脚手架命令(指定版本) npm install -g @vue/cli@5.0.8 # 查看版本 vue -V
Win + R -> cmd -> 选择版本执行安装。
问题一:在 vue 安装过程中遇到 npm error code ECONNRESET 是网络不是很好导致。
问题二:在 vue 安装过程中遇到 npm error code CERT_HAS_EXPIRED 是因为镜像源的问题,重新执行一下 3) 设置淘宝镜像及淘宝cnpm 就可以了。
问题三:如果使用 vue 指令表示 vue 不存在,可以重启电脑,如果既然不行,计算机属性 -> 高级系统设置 -> 环境变量 -> 用户变量 / Path 添加:
注意自己的路径,\AppData\Roaming\npm 是固定的。
2. 创建vue3项目
在本地目录下,找一个想要存放的路径。在路径栏 cmd 进入终端窗口。
# 创建项目
vue create 项目名
进来后使用 上下左右 方向键控制,空格选中,回车下一步。选错了关闭重来。
根据项目需求选择配置。
Banel | 将现代的JavaScript转译为兼容旧版本浏览器JavaScript代码。 |
TypeScript | TS是JavaScript的超集,增加了类型检查功能。 |
Progressive Web App(PWA)Support | 支持 PWA 特性,允许应用像原生应用一样在用户设备上运行。包括离线、推送通知等功能。 |
Router | Vue.js的官方路由库,允许在单页应用中实现不同页面的导航、转发。 |
Vuex | Vue.js的状态管理库,应用于管理应用的全局状态,方便多个组件之间共享数据。 |
CSS Pre-processors | 允许项目中使用CSS预处理器,扩展CSS功能。 |
Linter / Formatter | 严格模式,会检测代码是否符合规范。 |
Unit Testing | 单元测试。 |
E2E Testing(End-to-End Testing) | 端到端测试支持。 |
选好后回车选择版本。
yes==历史路由,浏览器 / 连接的路径。
回车后起个名字即可。
项目创建完成。 进入目录,运行就可以启动项目。
浏览器可以直接访问。
使用VScode打开项目 初始的样子。
启动项目在终端:
# 启动
npm run serve
# 打包
npm run build
停止项目运行,Ctrl + C。
3. 集成 Ant Design Vue UI
Ant Design Vue 是阿里云团队开源的基于Vue的UI组件。
UI 组件有很多,一类是基于CSS的Bootstrap,适合各种前端框架;一类是基于Vue的UI组件,仅用于Vue框架。
适合Vue的除了Ant Design Vue 还有 ElementUI。Vue3可以使用ElementPlus。
官网:https://antdv.com/components/overview
脚手架与项目都建好了,直接安装注册。
在终端输入命令
# 安装
npm i --save ant-design-vue
下载好后会有配置添加。
注册组件、CSS
全局引入:
问题一:
出现错误 Module not found: Error: Can't resolve 'ant-design-vue/es/style/css' in 'E:\Code\StarRail\star_web\src' 是因为官网给的指令 为 import 'ant-design-vue/dist/antd.css'; 与 node_modules 的文件不符。
问题二:
如果没有 node_modules 包,使用命令下载。
# 下载 node_modules
npm i
npm install
使用 组件
左侧有大量不同组件可以使用。
使用 Ant 的图标是需要 下载导入的。
# 终端
# 下载图标
npm install --save @ant-design/icons-vue
全局引入图标使用:
// 图标导入(全局)
import * as Icons from '@ant-design/icons-vue';
const app = createApp(App);
app.use(Antd).use(store).use(router).mount("#app");
// 引入全局图标
const icons = Icons;
for(const i in icons) {
app.component(i, icons[i]);
}
使用图标点击 复制,粘贴。
ERROR in [eslint]错误。
npm run serve启动报错时,可能开启了严格模式。
lintOnSave: false // 取消严格模式