Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslnode 18–226 runs
build_error
glibcnode 18–226 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
usePluginImport
✓ import usePluginImport from 'vite-plugin-importer'
✗ const usePluginImport = require('vite-plugin-importer')
Default export; ESM-only since v0.2
vite-plugin-importer (as Plugin)
✓ import usePluginImport from 'vite-plugin-importer'; export default { plugins: [usePluginImport({...})] }
✗ import { usePluginImport } from 'vite-plugin-importer'
Named import is incorrect; it's a default export
usePluginImport (with options)
✓ usePluginImport({ libraryName: 'antd', libraryDirectory: 'es', style: 'css' })
✗ usePluginImport('antd')
Options object required; same as babel-plugin-import config
Basic setup for ant-design-vue and antd with on-demand import and CSS injection.
// vite.config.js
import { defineConfig } from 'vite';
import usePluginImport from 'vite-plugin-importer';
export default defineConfig({
plugins: [
usePluginImport({
libraryName: 'ant-design-vue',
libraryDirectory: 'es',
style: 'css',
}),
usePluginImport({
libraryName: 'antd',
libraryDirectory: 'es',
style: 'css',
}),
],
});
Errors
Common errors & fixes
Cannot find module 'vite-plugin-importer'
Package not installed
fixnpm install vite-plugin-importer
TypeError: usePluginImport is not a function
Incorrect import: named import instead of default
fixUse default import: import usePluginImport from 'vite-plugin-importer'
SyntaxError: Cannot use import statement outside a module
Using ES import in CommonJS file without type: module
fixAdd "type": "module" to package.json or use .mjs extension
Audit
Dependencies
babel-plugin-importrequiredcore dependency for import transformation logic
magic-stringrequiredfor string manipulation in Vite transforms