What's the difference between unplugin-vue-macros and vue-macros? #988

tbontb-iaq · 2025-08-22T13:36:01Z

tbontb-iaq
Aug 22, 2025

So what's the difference between these two packages, and how should I choose which one in what situation?

Aug 22, 2025

Hey!

Basically, vue-macros is the new name for unplugin-vue-macros starting with v3. The old unplugin-vue-macros package is now deprecated.

So for any new project, you should just use vue-macros.

They explained it all in the migration guide here:

vue-macros/docs/guide/migration-v3.md

Lines 21 to 44 in 51afe87

     ## Main Package Rename  
    
   We have renamed the main package from `unplugin-vue-macros` to **`vue-macros`**.  
   After the official release of v3, `unplugin-vue-macros` will be marked as deprecated.  
    
   As a result, you will need to update your `package.json` and the import statements for Vue Macros:  
    
   ```diff  
   // package.json  
   {  
   "devDepen…

View full answer

vofronte · 2025-08-22T13:59:58Z

vofronte
Aug 22, 2025

Hey!

Basically, vue-macros is the new name for unplugin-vue-macros starting with v3. The old unplugin-vue-macros package is now deprecated.

So for any new project, you should just use vue-macros.

They explained it all in the migration guide here:

vue-macros/docs/guide/migration-v3.md

Lines 21 to 44 in 51afe87

    
           ## Main Package Rename 
        
           We have renamed the main package from `unplugin-vue-macros` to **`vue-macros`**. 
        
           After the official release of v3, `unplugin-vue-macros` will be marked as deprecated. 
        
           As a result, you will need to update your `package.json` and the import statements for Vue Macros: 
        
           ```diff 
        
            // package.json 
        
            { 
        
              "devDependencies": { 
        
           -    "unplugin-vue-macros": "^2.14.5" 
        
           +    "vue-macros": "^3.0.0" 
        
              } 
        
            } 
        
           ``` 
        
           ```diff 
        
           - import { $ref } from 'unplugin-vue-macros/macros' 
        
           + import { $ref } from 'vue-macros/macros' 
        
           - import VueMacros from 'unplugin-vue-macros/vite' 
        
           + import VueMacros from 'vue-macros/vite' 
        
           ```

2 replies

tbontb-iaq Aug 22, 2025
Author

Thanks, I see. But the latest version of vue-macros init command still seems to use unplugin-vue-macros.

vofronte Aug 22, 2025

Yeah, you're spot on. The problem is in the CLI tool's own package.json. You can see it right here: https://github.com/vue-macros/vue-macros-cli/blob/main/package.json It lists the old unplugin-vue-macros in its dev dependencies. So the CLI itself is just a bit behind the main package.

sxzz · 2025-08-22T21:11:41Z

sxzz
Aug 22, 2025
Maintainer

vue-macros-cli v1.3.0 is released now with Vue Macros v3 support.

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

What's the difference between unplugin-vue-macros and vue-macros? #988

Uh oh!

{{title}}

Uh oh!

Replies: 2 comments 2 replies

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

	## Main Package Rename

	We have renamed the main package from `unplugin-vue-macros` to `vue-macros`.
	After the official release of v3, `unplugin-vue-macros` will be marked as deprecated.

	As a result, you will need to update your `package.json` and the import statements for Vue Macros:

	```diff
	// package.json
	{
	"devDepen…

Uh oh!

What's the difference between unplugin-vue-macros and vue-macros? #988

Uh oh!

tbontb-iaq Aug 22, 2025

Replies: 2 comments · 2 replies

Uh oh!

Uh oh!

vofronte Aug 22, 2025

Uh oh!

tbontb-iaq Aug 22, 2025 Author

Uh oh!

vofronte Aug 22, 2025

Uh oh!

sxzz Aug 22, 2025 Maintainer

tbontb-iaq
Aug 22, 2025

Replies: 2 comments 2 replies

vofronte
Aug 22, 2025

tbontb-iaq Aug 22, 2025
Author

sxzz
Aug 22, 2025
Maintainer