Vant 按需引入导致 Typescript，eslint 报错问题

下雪天的夏风2024-09-15 23:14

1，按需引入问题

vant4 通过按需引入的配置使用组件时，会同时将样式也自动导入。所以可直接使用相关的 API 和组件，不会有问题。比如：

js 复制代码

showToast('提示内容');

但如果在按需引入配置的基础上，又再次导入，

js 复制代码

import { showToast } from 'vant';

showToast('提示内容');

同时没有在 src/main.ts 中导入相关样式文件，使用时样式就会出问题。

js 复制代码

import "vant/es/toast/style";

解决：2种方式不要混用。

2，Typescript 报错解决

通过按需引入的方式使用相关 API 时，在 .ts 文件中会有如下报错，因为没有显示导入，

一般来说，Typescript 的这个报错，可手动添加类型声明，声明使用了的全局变量即可。

解决：

通过 Vite 配置按需引入后，会在项目根目录下生成 auto-imports.d.ts，

ts 复制代码

/* eslint-disable */
/* prettier-ignore */
// @ts-nocheck
// noinspection JSUnusedGlobalSymbols
// Generated by unplugin-auto-import
export {}
declare global {
	const showToast: (typeof import("vant/es"))["showToast"];
}

这就是我们需要的类型声明文件，把它添加到 tsconfig.json 中即可。

json 复制代码

{
	// ...
	"include": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.vue", "auto-imports.d.ts"]
}

3，eslint 报错解决

同样的，因为没有显示导入，eslint 检查时也会有如下报错：

解决：在 .eslintrc.json 中设置全局变量即可。

json 复制代码

{
	// ...
	"globals": {
		"showToast": "readonly"
	}
}

以上。