Ant Design Vue 初步使用

本文介绍了如何使用 Vue-cli 3 创建项目,并详细讲解了Ant Design Vue的按需引入与全量引入方式,包括在babel.config.js中的配置以及在main.js中引入组件的方法。

注意:本文使用 npm 进行构建,yarn 方式请参考官方文档。

一、安装 vue-cli 3 脚手架,可以帮我们自动初始化一个脚手架并安装 Vue 项目的各种必要依赖

npm install -g @vue/cli

二、创建项目

vue create file-viewer

三. 在项目安装引入 Ant Design Vue 依赖

npm i --save ant-design-vue

四. 在项目中声明使用 Ant Design Vue,有两种方式:全量使用(导入 Antd 全部组件)和 按需使用(只导入使用到的部分组件)

      1. 全量使用。以下代码便完成了 Antd 的全量引入(在此引入后,即可在项目中任意位置使用Antd提供的组件而不需要单独的声明引入)。需要注意的是,样式文件需要单独引入。
 


import Vue from 'vue';
import Antd from 'ant-design-vue';
import App from './App';
import 'ant-design-vue/dist/antd.css';
Vue.config.productionTip = false;
 
Vue.use(Antd);
 
/* eslint-disable no-new */
new Vue({
  el: '#app',
  components: { App },
  template: '<App/>',
});

 2. 按需使用。需要使用到 babel-plugin-import 插件:一个用于按需加载组件代码和样式的 babel 插件

       2.1 在 babel.config.js 配置文件中加入下面的配置代码,其中 style 的值可以是 true: 表示自动引入样式文件,默认为 less,css: 表示引入 css 样式文件,less: 表示引入 less 样式文件
 

plugins: [
        [
          "import",
          { libraryName: "ant-design-vue", libraryDirectory: "es", style: 'css' }
        ]
      ]

  2.2 然后像上面全量引入一样在main.js引入你需要使用的组件即可

 

 

### 解决 Ant Design Vue 集成或运行时遇到的问题 #### 1. 确认安装版本兼容性 确保所使用的 `ant-design-vue` 版本与当前项目的 Vue 版本相匹配。对于 Vue 3 项目,推荐使用 `ant-design-vue` 的最新稳定版[^3]。 #### 2. 正确引入样式文件 除了 JavaScript 文件外,还需要确保正确引入了 Ant Design Vue 的 CSS 样式文件。可以采用如下方式: ```javascript import 'ant-design-vue/dist/antd.css'; // 或者仅加载重置样式 import 'ant-design-vue/dist/reset.css'; ``` 上述代码应放置于入口文件(如 main.js 或 main.ts)中以全局应用样式[^4]。 #### 3. 按需加载组件 如果只希望导入特定组件而非整个库,则可以通过 babel-plugin-import 插件实现按需加载,减少打包体积并提高性能。首先安装插件: ```bash npm install babel-plugin-import --save-dev ``` 接着修改 `.babelrc` 或相应的 Babel 配置文件来启用此功能[^5]。 #### 4. 检查依赖项冲突 有时其他依赖包可能会干扰 Ant Design Vue 的正常工作。建议清理 node_modules 并重新安装所有依赖: ```bash rm -rf node_modules package-lock.json yarn.lock npm cache clean --force npm install ``` 这有助于排除因缓存或其他因素引起的潜在问题[^1]。 #### 5. 浏览器控制台报错排查 当浏览器开发者工具显示错误信息时,请仔细阅读这些提示,它们往往能提供解决问题的关键线索。常见的错误可能涉及路径配置不当、缺少 polyfill 支持等问题[^2]。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值