Installer
Répertoire
- Ligne de commande outil
- Explication des différentes versions
- terminologie
- Chargeur de module AMD
- Compatibilité
- ne prend pas en charge IE8 et versions antérieures, car Vue utilise des fonctionnalités ECMAScript 5 que IE8 ne peut pas émuler. Mais il prend en charge tous les
- navigateurs compatibles ECMAScript 5
Journal des modifications
Dernière version stable : 2.6.10Voir le journal des modifications de chaque version sur
GitHub
Vue Devtools
Lorsque vous utilisez Vue, nous vous recommandons d'installer Vue Devtools sur votre navigateur. Il vous permet de réviser et de déboguer les applications Vue dans une interface plus conviviale.
Utilisez directement <script>
pour importer
Téléchargez et utilisez directement la balise <script>
pour importer, Vue code> sera enregistré en tant que variable globale.
N'utilisez pas la version compressée dans un environnement de développement, sinon vous perdrez tous les avertissements concernant les erreurs courantes
comprend des avertissements complets et un mode de débogage
Production Version Avertissement réalisé, 33.30Kb min + gzip
cdn
pour le prototypage ou l'apprentissage, vous pouvez utiliser la dernière version comme celle-ci:
<script src="https://cdn.jsdelivr.net/npm/vue"></script>
pour les environnements de production, nous recommandons Lien vers un numéro de version clair et un fichier de build pour éviter les dommages inattendus causés par les nouvelles versions :
<script src="https://cdn.jsdelivr.net/npm/vue@2.6.10/dist/vue.js"></script>
Si vous utilisez des modules ES natifs, il existe également un fichier de build compatible avec le module ES ici :
<script type="module"> import Vue from 'https://cdn.jsdelivr.net/npm/vue@2.6.10/dist/vue.esm.browser.js' </script>
Vous pouvez le trouver sur cdn .jsdelivr.net/npm/vue Parcourez le code source du package NPM.
Vue est également disponible sur unpkg et cdnjs (la mise à jour de la version de cdnjs est peut-être légèrement en retard).
Veuillez vous assurer de comprendre les différentes versions de build et d'utiliser la version de l'environnement de production dans votre site publié, vue.js
换成 vue.min.js
. Il s'agit d'une version plus petite qui permet une expérience beaucoup plus rapide que l'environnement de développement.
NPM
Il est recommandé d'utiliser l'installation de NPM lors de la création d'applications volumineuses avec Vue[1]. NPM fonctionne bien avec les bundlers de modules comme webpack ou Browserify. Dans le même temps, Vue fournit également des outils de support pour développer des composants à fichier unique.
# 最新稳定版 $ npm install vue
Outil de ligne de commande (CLI)
Vue fournit une CLI officielle pour créer rapidement un échafaudage complexe pour les applications à page unique (SPA). Il fournit des paramètres de construction inclus avec des piles pour les flux de travail frontaux modernes. Il ne prend que quelques minutes pour être opérationnel et est livré avec un rechargement à chaud, une vérification des peluches lors de la sauvegarde et une version prête pour la production. Pour plus de détails, veuillez consulter la Documentation Vue CLI.
Les outils CLI supposent que les utilisateurs ont un certain niveau de compréhension de Node.js et des outils de construction associés. Si vous êtes nouveau sur Vue, nous vous recommandons fortement de lire d'abord le Guide sans outil de construction, puis de vous familiariser avec Vue elle-même avant d'utiliser la CLI.
Explication des différentes builds
Dans le répertoire du dist/
Package NPM, vous trouverez de nombreuses builds Vue.js différentes. Les différences entre eux sont répertoriées ici :
UMD | CommonJS | Module ES (basé sur l'utilisation de l'outil de build) | Module ES (directement utilisé dans le navigateur) | |
---|---|---|---|---|
Le la version complète | vue.js | vue.common.js | vue.esm.js | vue.esm.browser.js |
contient uniquement la version d'exécution | vue.runtime.js | vue.runtime.common.js | vue.runtime.esm.js | - |
Version complète (environnement de production) | vue.min.js | - | - | vue.esm .browser.min.js |
contient uniquement la version d'exécution (environnement de production) | vue.runtime.min.js | - | - | - |
Conditions
Version complète : La version qui inclut à la fois le compilateur et le runtime.
Compilateur : Code utilisé pour compiler des chaînes de modèles dans des fonctions de rendu JavaScript.
Runtime : Code utilisé pour créer des instances Vue, rendre et traiter le DOM virtuel, etc. En gros, tout le reste sauf le compilateur.
UMD : La version UMD est utilisable directement dans le navigateur via la balise
<script>
. https://cdn.jsdelivr.net/npm/vue<script>
标签直接用在浏览器中。jsDelivr CDN 的 https://cdn.jsdelivr.net/npm/vue 默认文件就是运行时 + 编译器的 UMD 版本 (vue.js
)。CommonJS:CommonJS 版本用来配合老的打包工具比如 Browserify 或 webpack 1。这些打包工具的默认文件 (
pkg.main
) 是只包含运行时的 CommonJS 版本 (vue.runtime.common.js
)。ES Module:从 2.6 开始 Vue 会提供两个 ES Modules (ESM) 构建文件:
运行时 + 编译器 vs. 只包含运行时
如果你需要在客户端编译模板 (比如传入一个字符串给 template
选项,或挂载到一个元素上并以其 DOM 内部的 HTML 作为模板),就将需要加上编译器,即完整版:
// 需要编译器 new Vue({ template: '<div>{{ hi }}</div>' }) // 不需要编译器 new Vue({ render (h) { return h('div', this.hi) } })
当使用 vue-loader
或 vueify
的时候,*.vue
de la version jsDelivr CDN UMD (vue. js
).
pkg.main
) est la version d'exécution uniquement de CommonJS (vue.runtime.common.js
). 🎜🎜🎜🎜🎜ES Module🎜🎜 : à partir de la version 2.6, Vue fournira deux fichiers de construction de modules ES (ESM) : 🎜- 🎜🎜ESM pour les outils de packaging : pour des outils tels que Outils de regroupement modernes fournis par webpack 2🎜 ou Rollup🎜. Le format ESM est conçu pour être analysé statiquement, de sorte que les outils de packaging peuvent en profiter pour effectuer un « tree-shaking » et exclure le code inutilisé du package final. Le fichier par défaut (
pkg.module
) fourni pour ces outils d'empaquetage est une version de module ES uniquement d'exécution (vue.runtime.esm.js
). 🎜🎜🎜🎜ESM pour navigateurs (2.6+) : pour une importation directe dans les navigateurs modernes via <script type="module">
🎜🎜🎜🎜 runtime + compilateur vs runtime uniquement 🎜🎜🎜🎜 si vous devez compiler le modèle côté client (par exemple en passant une chaîne à l'option template
, ou en le montant sur un élément et en utilisant le HTML à l'intérieur de son DOM comme modèle), vous devrez ajouter le compilateur, c'est-à-dire la version complète : 🎜
module.exports = { // ... resolve: { alias: { 'vue$': 'vue/dist/vue.esm.js' // 用 webpack 1 时需用 'vue/dist/vue.common.js' } } }🎜Lorsque vous utilisez
vue-loader code> ou vueify
, les modèles contenus dans les fichiers *.vue
seront pré-compilés en JavaScript lors de la construction. Vous n'avez pas réellement besoin d'un compilateur dans le package final, utilisez donc simplement la version d'exécution. 🎜Étant donné que la version d'exécution est environ 30 % plus petite que la version complète, vous devez utiliser cette version autant que possible. Si vous souhaitez toujours utiliser la version complète, vous devez configurer un alias dans l'outil de packaging :
webpack
const alias = require('rollup-plugin-alias')
rollup({ // ...
plugins: [
alias({ 'vue': require.resolve('vue/dist/vue.esm.js')
})
]
})
Rollup
{ // ...
"browser": { "vue": "vue/dist/vue.common.js"
}
}
Browserify
ajouter au package.json de votre projet code> : package.json
:
{ // ...
"alias": { "vue" : "./node_modules/vue/dist/vue.common.js"
}
}
Parcel
在你项目的 package.json
中添加:
module.exports = {
mode: 'production'
}
开发环境 vs. 生产环境模式
对于 UMD 版本来说,开发环境/生产环境模式是硬编码好的:开发环境下用未压缩的代码,生产环境下使用压缩后的代码。
CommonJS 和 ES Module 版本是用于打包工具的,因此我们不提供压缩后的版本。你需要自行将最终的包进行压缩。
CommonJS 和 ES Module 版本同时保留原始的 process.env.NODE_ENV
检测,以决定它们应该运行在什么模式下。你应该使用适当的打包工具配置来替换这些环境变量以便控制 Vue 所运行的模式。把 process.env.NODE_ENV
替换为字符串字面量同时可以让 UglifyJS 之类的压缩工具完全丢掉仅供开发环境的代码块,以减少最终的文件尺寸。
webpack
在 webpack 4+ 中,你可以使用 mode
选项:
var webpack = require('webpack')
module.exports = {
// ...
plugins: [
// ...
new webpack.DefinePlugin({
'process.env': {
NODE_ENV: JSON.stringify('production')
}
})
]
}
但是在 webpack 3 及其更低版本中,你需要使用 DefinePlugin:
const replace = require('rollup-plugin-replace')
rollup({
// ...
plugins: [
replace({
'process.env.NODE_ENV': JSON.stringify('production')
})
]
}).then(...)
Rollup
NODE_ENV=production browserify -g envify -e main.js | uglifyjs -c -m > build.js
Browserify
为你的包应用一次全局的 envify 转换。
git clone https://github.com/vuejs/vue.git node_modules/vue
cd node_modules/vue
npm install
npm run build
也可以移步生产环境部署。
CSP 环境
有些环境,如 Google Chrome Apps,会强制应用内容安全策略 (CSP),不能使用 new Function()
对表达式求值。这时可以用 CSP 兼容版本。完整版本依赖于该功能来编译模板,所以无法在这些环境下使用。
另一方面,运行时版本则是完全兼容 CSP 的。当通过 webpack + vue-loader 或者 Browserify + vueify 构建时,模板将被预编译为 render
# 最新稳定版本
$ bower install vue
Parcel
🎜Dans le package.json
de votre projet, ajoutez : 🎜rrreee🎜🎜🎜🎜Environnement de développement vs mode environnement de production🎜🎜🎜Pour la version UMD, le mode environnement de développement/environnement de production est codé en dur : utilisez du code non compressé dans l'environnement de développement et utilisez du code non compressé dans l'environnement de production Utilisez le code compressé ci-dessous. 🎜🎜Les versions CommonJS et ES Module sont destinées aux outils de packaging, nous ne fournissons donc pas de versions minifiées. Vous devez compresser vous-même le package final. 🎜🎜Les versions CommonJS et ES Module conservent également la détection d'origine process.env.NODE_ENV
pour déterminer dans quel mode elles doivent s'exécuter. Vous devez remplacer ces variables d'environnement par la configuration de l'outil d'empaquetage appropriée pour contrôler le mode dans lequel Vue est exécuté. Le remplacement de process.env.NODE_ENV
par une chaîne littérale permet également aux outils de compression comme UglifyJS de supprimer complètement les blocs de code réservés au développement, réduisant ainsi la taille du fichier final. 🎜🎜🎜webpack🎜🎜🎜Dans webpack 4+, vous pouvez utiliser l'option mode
: 🎜rrreee🎜Mais dans webpack 3 et versions antérieures, vous devez utiliser DefinePlugin : 🎜rrreee🎜🎜Rollup🎜🎜🎜Utilisez rollup-plugin-replace : 🎜rrreee🎜🎜Browserify🎜🎜🎜Appliquer un envify. 🎜rrreee🎜Vous pouvez également passer au déploiement d'un environnement de production. 🎜🎜🎜🎜
🎜Environnement CSP🎜🎜🎜Certains environnements, tels que Google Chrome Apps, forceront l'application du contenu Politique de sécurité ( CSP), vous ne pouvez pas utiliser new Function()
pour évaluer des expressions. Dans ce cas, la version compatible CSP peut être utilisée. La version complète s'appuie sur cette fonctionnalité pour compiler des modèles, elle ne peut donc pas être utilisée dans ces environnements. 🎜🎜D'autre part, la version runtime est entièrement compatible avec CSP. Lors du passage de webpack + vue-loader ou Browserify + vueify Lors de la construction, le modèle sera pré-compilé dans une fonction render
, qui peut fonctionner parfaitement dans un environnement CSP. 🎜🎜🎜🎜
Version de développement
Important : Le dossier /dist
du référentiel GitHub ne sera validé que lorsqu'une nouvelle version sera publiée. Si vous souhaitez utiliser le dernier code source de Vue sur GitHub, vous devez le construire vous-même !
rrreee
Bower
Bower est uniquement disponible en version UMD.
rrreee
AMD Module Loader
Toutes les versions UMD peuvent être utilisées directement comme modules AMD.
Note du traducteur
[1] Pour les utilisateurs de Chine continentale, il est recommandé de définir la source NPM sur un miroir domestique, ce qui peut grandement améliorer la vitesse d'installation.