Which dist file to use?
From CDN or without a Bundler
<script src="...">in the browser. Exposes the
Vueglobal. - Note that global builds are not UMD builds. They are built as IIFEs and is only meant for direct use via
<script src="...">. - In-browser template compilation:
- Inlines all Vue core internal packages - i.e. it's a single file with no dependencies on other files. This means you must import everything from this file and this file only to ensure you are getting the same instance of code. - Contains hard-coded prod/dev branches, and the prod build is pre-minified. Use the
- **`vue.global.js`** is the "full" build that includes both the compiler and the runtime so it supports compiling templates on the fly. - **`vue.runtime.global.js`** contains only the runtime and requires templates to be pre-compiled during a build step.
*.prod.jsfiles for production.
<script type="module">. - Shares the same runtime compilation, dependency inlining and hard-coded prod/dev behavior with the global build.
With a Bundler
- For use with bundlers like
parcel. - Leaves prod/dev branches with
process.env.NODE_ENVguards (must be replaced by bundler) - Does not ship minified builds (to be done together with the rest of the code after bundling) - Imports dependencies (e.g.
- In-browser template compilation:
- Imported dependencies are also `esm-bundler` builds and will in turn import their dependencies (e.g. `@vue/runtime-core` imports `@vue/reactivity`) - This means you **can** install/import these deps individually without ending up with different instances of these dependencies, but you must make sure they all resolve to the same version.
Bundler Build Feature FlagsStarting with 3.0.0-rc.3,
esm-bundlerbuilds now exposes global feature flags that can be overwritten at compile time:
__VUE_OPTIONS_API__(enable/disable Options API support, default:
__VUE_PROD_DEVTOOLS__(enable/disable devtools support in production, default:
The build will work without configuring these flags, however it is strongly recommended to properly configure them in order to get proper tree-shaking in the final bundle. To configure these flags:
- webpack: use DefinePlugin
- Rollup: use @rollup/plugin-replace
- Vite: configured by default, but can be overwritten using the
Note: the replacement value must be boolean literals and cannot be strings, otherwise the bundler/minifier will not be able to properly evaluate the conditions.
For Server-Side Rendering
require(). - If you bundle your app with webpack with
target: 'node'and properly externalize
vue, this is the build that will be loaded. - The dev/prod files are pre-built, but the appropriate file is automatically required based on