fix: 更新 README 和代码以支持 Ant Design Vue >= 2.2.0-beta.6 版本，修复版本兼容性检查

cklwblove · cklwblove · commit 72414457cefd · 2025-09-15T09:47:18.000+08:00
diff --git a/README.md b/README.md
@@ -14,7 +14,7 @@
 
 - 🚀 **自动导入组件** - 无需手动导入，直接使用 Ant Design Vue 组件
 - 🎨 **自动导入样式** - 自动处理样式文件的导入
-- 📦 **版本兼容** - 支持 Ant Design Vue 1.x 和 4.x 版本
+- 📦 **版本兼容** - 支持 Ant Design Vue >= 2.2.0-beta.6 版本
 - 🔧 **智能检测** - 自动检测项目中的依赖版本
 - ⚡ **按需加载** - 只导入使用的组件，减小打包体积
 
@@ -83,15 +83,14 @@ export default defineConfig({
 
 ## 依赖要求
 
-- `ant-design-vue`: ^4.0.0
+- `ant-design-vue`: ^2.2.0-beta.6
 - `vue`: ^3.0.0
 
 ## 版本兼容性
 
 | 插件版本 | Ant Design Vue 版本 | Vue 版本 |
 |---------|-------------------|----------|
-| ^1.0.0  | ^4.0.0           | ^3.0.0   |
-| ^1.0.0  | ^1.x             | ^2.0.0   |
+| ^1.0.0  | ^2.2.0-beta.6    | ^3.0.0   |
 
 ## 工作原理
 
diff --git a/src/index.ts b/src/index.ts
@@ -8,7 +8,11 @@ interface PackageJson {
   devDependencies?: Record<string, string>;
 }
 
-function resolveProjectDep(opts: { pkg: PackageJson; cwd: string; dep: string }) {
+function resolveProjectDep(opts: {
+  pkg: PackageJson;
+  cwd: string;
+  dep: string;
+}) {
   if (
     opts.pkg.dependencies?.[opts.dep] ||
     opts.pkg.devDependencies?.[opts.dep]
@@ -25,56 +29,57 @@ function compareVersion(version: string, targetVersion: string): number {
   const parseVersion = (v: string) => {
     // 解析版本号，处理 beta/alpha/rc 等预发布版本
     const match = v.match(/^(\d+)\.(\d+)\.(\d+)(?:-(.+?)\.(\d+))?/);
-    if (!match) return { major: 0, minor: 0, patch: 0, prerelease: '', prereleaseNum: 0 };
-    
+    if (!match)
+      return { major: 0, minor: 0, patch: 0, prerelease: '', prereleaseNum: 0 };
+
     return {
       major: parseInt(match[1], 10),
       minor: parseInt(match[2], 10),
       patch: parseInt(match[3], 10),
       prerelease: match[4] || '',
-      prereleaseNum: parseInt(match[5] || '0', 10)
+      prereleaseNum: parseInt(match[5] || '0', 10),
     };
   };
-  
+
   const v1 = parseVersion(version);
   const v2 = parseVersion(targetVersion);
-  
+
   // 比较主版本号
   if (v1.major !== v2.major) return v1.major - v2.major;
   // 比较次版本号
   if (v1.minor !== v2.minor) return v1.minor - v2.minor;
   // 比较修订版本号
   if (v1.patch !== v2.patch) return v1.patch - v2.patch;
-  
+
   // 如果都没有预发布版本，则相等
   if (!v1.prerelease && !v2.prerelease) return 0;
-  
+
   // 正式版本大于预发布版本
   if (!v1.prerelease && v2.prerelease) return 1;
   if (v1.prerelease && !v2.prerelease) return -1;
-  
+
   // 比较预发布版本
   if (v1.prerelease !== v2.prerelease) {
     return v1.prerelease.localeCompare(v2.prerelease);
   }
-  
+
   // 比较预发布版本号
   return v1.prereleaseNum - v2.prereleaseNum;
 }
 
 function checkVersionCompatibility(version: string) {
   const minRequiredVersion = '2.2.0-beta.6';
-  
+
   // 检查是否满足最低版本要求
   if (compareVersion(version, minRequiredVersion) < 0) {
     console.warn(
       `[winjs-plugin-antdv] 警告：当前 ant-design-vue 版本 (${version}) 不支持 AntDesignVueResolver。\n` +
-      `AntDesignVueResolver 需要 ant-design-vue@${minRequiredVersion} 或更高版本。\n` +
-      `请升级您的 ant-design-vue 版本：npm install ant-design-vue@latest`
+        `AntDesignVueResolver 需要 ant-design-vue@${minRequiredVersion} 或更高版本。\n` +
+        `请升级您的 ant-design-vue 版本：npm install ant-design-vue@latest`,
     );
     return false;
   }
-  
+
   return true;
 }
 
@@ -85,15 +90,14 @@ export default (api: IApi) => {
       resolveProjectDep({
         pkg: api.pkg,
         cwd: api.cwd,
-        dep: 'ant-design-vue'
+        dep: 'ant-design-vue',
       }) || dirname(require.resolve('ant-design-vue/package.json'));
-  } catch (_) {
-  }
+  } catch (_) {}
 
   function checkPkgPath() {
     if (!pkgPath) {
       throw new Error(
-        `Can't find ant-design-vue package. Please install antd first.`
+        `Can't find ant-design-vue package. Please install antd first.`,
       );
     }
   }
@@ -106,7 +110,7 @@ export default (api: IApi) => {
     checkVersionCompatibility(antdvVersion);
     memo.antdv = {
       pkgPath,
-      version: antdvVersion
+      version: antdvVersion,
     };
     return memo;
   });
@@ -119,64 +123,93 @@ export default (api: IApi) => {
           .object({
             exclude: zod
               .array(zod.string())
-              .describe('排除自动导入的组件列表。数组元素为组件名称（不含前缀），如 ["Button", "Input"]。被排除的组件需要手动导入。')
+              .describe(
+                '排除自动导入的组件列表。数组元素为组件名称（不含前缀），如 ["Button", "Input"]。被排除的组件需要手动导入。',
+              )
               .default([])
               .optional(),
             importStyle: zod
-              .union([zod.boolean(), zod.literal('css'), zod.literal('less'), zod.literal('css-in-js')])
-              .describe('样式导入方式。true 或 "css" 导入编译后的 CSS 文件，"less" 导入 Less 源文件以支持主题定制，"css-in-js" 导入 CSS-in-JS 样式，false 不自动导入样式。默认为 "css"。')
+              .union([
+                zod.boolean(),
+                zod.literal('css'),
+                zod.literal('less'),
+                zod.literal('css-in-js'),
+              ])
+              .describe(
+                '样式导入方式。true 或 "css" 导入编译后的 CSS 文件，"less" 导入 Less 源文件以支持主题定制，"css-in-js" 导入 CSS-in-JS 样式，false 不自动导入样式。默认为 "css"。',
+              )
               .optional(),
             resolveIcons: zod
               .boolean()
-              .describe('是否自动解析和导入 Ant Design Vue 的图标组件。设为 true 时，将自动解析并导入图标组件，无需手动导入。需要安装 @ant-design/icons-vue 包。默认为 false。')
+              .describe(
+                '是否自动解析和导入 Ant Design Vue 的图标组件。设为 true 时，将自动解析并导入图标组件，无需手动导入。需要安装 @ant-design/icons-vue 包。默认为 false。',
+              )
               .default(false)
               .optional(),
             cjs: zod
               .boolean()
-              .describe('是否使用 CommonJS 构建版本。设为 true 时使用 CommonJS 构建，false 使用 ES 模块构建。默认为 false。')
+              .describe(
+                '是否使用 CommonJS 构建版本。设为 true 时使用 CommonJS 构建，false 使用 ES 模块构建。默认为 false。',
+              )
               .default(false)
               .optional(),
             packageName: zod
               .string()
-              .describe('重命名包名。用于指定 ant-design-vue 包的别名或自定义包名。默认为 "ant-design-vue"。')
+              .describe(
+                '重命名包名。用于指定 ant-design-vue 包的别名或自定义包名。默认为 "ant-design-vue"。',
+              )
               .default('ant-design-vue')
               .optional(),
             prefix: zod
               .string()
-              .describe('组件名称前缀。默认为 "A"，对应 "AButton"、"AInput" 等组件名。如需自定义可修改此配置。')
+              .describe(
+                '组件名称前缀。默认为 "A"，对应 "AButton"、"AInput" 等组件名。如需自定义可修改此配置。',
+              )
               .default('A')
-              .optional()
+              .optional(),
           })
-          .describe('Ant Design Vue 自动导入插件配置。集成 unplugin-vue-components 的 AntDesignVueResolver，提供 Ant Design Vue 组件和样式的按需自动导入功能，支持 Vue2 和 Vue3 版本。')
+          .describe(
+            'Ant Design Vue 自动导入插件配置。集成 unplugin-vue-components 的 AntDesignVueResolver，提供 Ant Design Vue 组件和样式的按需自动导入功能，支持 Vue2 和 Vue3 版本。',
+          )
           .optional()
           .default({});
-      }
+      },
     },
-    enableBy: api.EnableBy.config
+    enableBy: api.EnableBy.config,
   });
 
   // 获取用户配置，如果没有配置则使用默认值
   const userConfig = api.config.antdv || {};
   const resolverConfig = {
     // 排除的组件列表：默认为空数组
-    ...(userConfig.exclude && userConfig.exclude.length > 0 && { exclude: userConfig.exclude }),
+    ...(userConfig.exclude &&
+      userConfig.exclude.length > 0 && { exclude: userConfig.exclude }),
     // 样式导入方式：用户配置优先，否则使用默认值 'css'
-    importStyle: userConfig.importStyle !== undefined ? userConfig.importStyle : 'css',
+    importStyle:
+      userConfig.importStyle !== undefined ? userConfig.importStyle : 'css',
     // 是否解析图标：默认为 false
-    resolveIcons: userConfig.resolveIcons !== undefined ? userConfig.resolveIcons : false,
+    resolveIcons:
+      userConfig.resolveIcons !== undefined ? userConfig.resolveIcons : false,
     // 是否使用 CommonJS：默认为 false
     ...(userConfig.cjs !== undefined && { cjs: userConfig.cjs }),
     // 包名：默认为 'ant-design-vue'
-    ...(userConfig.packageName && userConfig.packageName !== 'ant-design-vue' && { packageName: userConfig.packageName }),
+    ...(userConfig.packageName &&
+      userConfig.packageName !== 'ant-design-vue' && {
+        packageName: userConfig.packageName,
+      }),
     // 组件前缀：默认为 'A'
-    ...(userConfig.prefix && userConfig.prefix !== 'A' && { prefix: userConfig.prefix })
+    ...(userConfig.prefix &&
+      userConfig.prefix !== 'A' && { prefix: userConfig.prefix }),
   };
 
   const unComponents = {
-    resolvers: [AntDesignVueResolver(resolverConfig)]
+    resolvers: [AntDesignVueResolver(resolverConfig)],
   };
 
-  api.userConfig.autoImport = deepmerge({
-    unComponents
-  }, api.userConfig.autoImport || {});
-}
+  api.userConfig.autoImport = deepmerge(
+    {
+      unComponents,
+    },
+    api.userConfig.autoImport || {},
+  );
+};
