Installer


Répertoire

  • Vue Devtools

  • Utilisez directement <script>

    • NPM

  • Ligne de commande outil
  • Explication des différentes versions
  • terminologie
    • environnement de développement + compilateur vs. mode environnement
    • Environnement CSP
    • Version de développement

    • Bower

  • Chargeur de module AMD
  • Compatibilité
  • Vue

    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 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


La version de développement

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 :


UMDCommonJSModule ES (basé sur l'utilisation de l'outil de build)Module ES (directement utilisé dans le navigateur)
Le la version complète vue.jsvue.common.jsvue.esm.jsvue.esm.browser.js
contient uniquement la version d'exécutionvue.runtime.js vue.runtime.common.jsvue.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 版本用来配合老的打包工具比如 Browserifywebpack 1。这些打包工具的默认文件 (pkg.main) 是只包含运行时的 CommonJS 版本 (vue.runtime.common.js)。

  • ES Module:从 2.6 开始 Vue 会提供两个 ES Modules (ESM) 构建文件:

    • 为打包工具提供的 ESM:为诸如 webpack 2Rollup 提供的现代打包工具。ESM 格式被设计为可以被静态分析,所以打包工具可以利用这一点来进行“tree-shaking”并将用不到的代码排除出最终的包。为这些打包工具提供的默认文件 (pkg.module) 是只有运行时的 ES Module 构建 (vue.runtime.esm.js)。

    • 为浏览器提供的 ESM (2.6+):用于在现代浏览器中通过 <script type="module"> 直接导入


运行时 + 编译器 vs. 只包含运行时

如果你需要在客户端编译模板 (比如传入一个字符串给 template 选项,或挂载到一个元素上并以其 DOM 内部的 HTML 作为模板),就将需要加上编译器,即完整版:

// 需要编译器
new Vue({
  template: '<div>{{ hi }}</div>'
})
// 不需要编译器
new Vue({
  render (h) {
    return h('div', this.hi)
  }
})

当使用 vue-loadervueify 的时候,*.vue de la version jsDelivr CDN UMD (vue. js).

🎜🎜🎜🎜CommonJS🎜🎜 : La version CommonJS est utilisée pour travailler avec d'anciens outils d'empaquetage tels que < a href= "http://browserify.org/" target="_blank">Browserify🎜 ou webpack 1🎜. Le fichier par défaut de ces outils de packaging (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) : 🎜🎜< /ul>🎜🎜🎜

🎜🎜 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 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  : 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

使用 rollup-plugin-replace

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.