Élagage de l’arbre et import automatique
Exports nommés pour l’élagage de l’arbre, intégration d’unplugin-vue-components et configuration du résolveur
Élagage de l’arbre et import automatique est une leçon Vue Academy gratuite sur CoddyKit. Ceci est la leçon 3 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Vue Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Vue Academy comprend 4 leçons au total.
Qu’est-ce que l’élimination des branches inutilisées
L’élimination des branches inutilisées consiste à supprimer le code mort : un outil de regroupement supprime les exportations que l’utilisateur n’importe jamais. Une bibliothèque bien conçue permet aux applications de n’inclure que les composants utilisés, ce qui maintient des paquets de petite taille.
Les exportations nommées la permettent
Utilisez des exportations nommées depuis votre point d’entrée afin que chaque import puisse être analysé statiquement. Une unique exportation par défaut contenant tout (un objet de regroupement) ne peut pas bénéficier de l’élimination des branches inutilisées.
// GOOD: named exports
export { MyButton } from "./MyButton.vue";
export { MyCard } from "./MyCard.vue";Éviter un objet de regroupement par défaut
Exporter un seul objet contenant tous les composants force les outils de regroupement à tous les conserver, même si l’application n’en utilise qu’un.
// BAD: defeats tree-shaking
export default { MyButton, MyCard, MyTable };L’utilisateur importe ce dont il a besoin
Avec les exportations nommées, l’utilisateur ne déstructure que les composants utilisés et le reste est supprimé de sa compilation.
import { MyButton } from "my-ui-lib";
// MyCard, MyTable are never bundledLe champ sideEffects
Les outils de regroupement supposent que les modules peuvent avoir des effets de bord et les conservent. Définir "sideEffects": false dans package.json leur indique que vos modules sont purs et peuvent être supprimés sans risque.
{
"sideEffects": false
}Déclarer les effets de bord du CSS
Si votre paquet contient des imports CSS qui ne doivent pas être supprimés, répertoriez-les afin que seuls ceux-ci soient conservés.
{
"sideEffects": ["**/*.css"]
}Importation automatique pour les utilisateurs
Pour éviter les imports manuels aux utilisateurs, les bibliothèques fournissent un résolveur pour unplugin-vue-components, qui importe automatiquement les composants utilisés dans les modèles.
npm install -D unplugin-vue-componentsFournir un résolveur
Un résolveur est une fonction qui, à partir du nom d’un composant utilisé, indique depuis où l’importer. Fournissez-en un avec votre paquet.
// my-ui-lib/resolver.js
export function MyUiResolver() {
return {
type: "component",
resolve: (name) => {
if (name.startsWith("My")) {
return { name, from: "my-ui-lib" };
}
}
};
}Configuration côté utilisateur
L’utilisateur enregistre le plugin avec votre résolveur. Les composants utilisés dans les modèles sont alors importés automatiquement tout en bénéficiant de l’élimination des branches inutilisées.
// consumer vite.config.ts
import Components from "unplugin-vue-components/vite";
import { MyUiResolver } from "my-ui-lib/resolver";
export default defineConfig({
plugins: [
vue(),
Components({ resolvers: [MyUiResolver()] })
]
});Importation automatique et élimination des branches inutilisées
Comme le résolveur transforme l’utilisation dans les modèles en véritables imports nommés, seuls les composants utilisés sont intégrés : vous conservez à la fois la simplicité d’utilisation et des paquets de petite taille.
Éviter l’enregistrement global
Une bibliothèque qui enregistre automatiquement tous les composants via app.use empêche l’élimination des branches inutilisées. Préférez les exportations nommées et un résolveur facultatif afin que les utilisateurs choisissent les composants individuellement.
Vérification rapide
Quel paramètre de package.json indique aux outils de regroupement que vos modules peuvent être soumis à l’élimination des branches inutilisées ?
Récapitulatif
Activez l’élimination des branches inutilisées en utilisant des exportations nommées (jamais un objet de regroupement par défaut) et en définissant "sideEffects": false (ou en répertoriant le CSS). Pour faciliter l’utilisation, fournissez un résolveur unplugin-vue-components afin que les utilisateurs importent automatiquement les composants utilisés tout en n’intégrant que ceux dont ils ont besoin, et évitez d’imposer un enregistrement global.
Apprends HTML avec un tuteur IA — gratuit
Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.
- Cours
- 42
- Leçons
- 156
Questions Fréquemment Posées
La leçon « Élagage de l’arbre et import automatique » est-elle gratuite ?
Oui — le texte complet de « Élagage de l’arbre et import automatique » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Vue Academy, passe à CoddyKit PRO. Le cours Vue Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Élagage de l’arbre et import automatique » ?
Exports nommés pour l’élagage de l’arbre, intégration d’unplugin-vue-components et configuration du résolveur Tu pratiques Vue Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Vue Academy ?
Aucune expérience préalable n'est requise. Vue Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 3 sur 4.
Combien de temps prend la leçon « Élagage de l’arbre et import automatique » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Vue Academy ?
Oui. Chaque leçon Vue Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Configurer le mode bibliothèque de Vite
- Déclarations TypeScript pour les bibliothèques de composants
- Élagage de l’arbre et import automatique
- Publier sur npm et gérer le versionnage sémantique