Back to "Модернізація фронтального конвеєра Pipeline: Від CDN до Bundling"

This is a viewer only at the moment see the article on how this works.

To update the preview hit Ctrl-Alt-R (or ⌘-Alt-R on Mac) or Enter to refresh. The Save icon lets you save the markdown file to disk

This is a preview from the server running through my markdig pipeline

ASP.NET Frontend Tailwind Webpack

Модернізація фронтального конвеєра Pipeline: Від CDN до Bundling

Tuesday, 11 November 2025

Введение

Протягом минулого року – МСК0, я – МSK1 – зіткнувся з помилками, МSK2 – експериментував, , – поламав речі, МСК4 – поступово модернізував конструкцію фронтального модуля для цього блогу. МSK5 – Це не був МSK6 – не був якийсь бездоганний план, а МSK7 – це був спроба і помилка, МСК8 – багато помилок, ММСК9 – і завзята наполегливість, керована чітким баченням того, що я хотів досягти. ММСк10

I' я не фронтальний гуру чи веб-магістр, а я - програміст NET, який розчарувався обмеженнями залежності від CDN, і вирішив, що має бути кращий спосіб. <script> ярлики, що наводять на Unpkg до nowoczesneї конвеєрної ланцюги, яка дійсно працює.

Я зробив багато помилок на шляху. (, який я ' задокументую, МSK2 витратив години на виправлення хибних помилок вебпакета node_modules більше разів, ніж я зважаю визнати

Якщо ви - програміст .NET, який дивиться на комп 'ютерні файли Webpack і думає: Що ж на Землі в тебе вийшло? , - ось вам ця стаття

I' я старий веб-перспективний божевільник , в ранніх днях телефонного зв 'язку МSK2 перший сайт, який я побудував за гроші M SK3 це був не МSK4 не порновенґенд в Перлі М SK5 історія для іншого часу ) це сайт Snow Conditions, що вийшов з автоматизованої телефонної лінії

У ті дні проблеми були зовсім різними . JavaScript був практично невідомим МSK1 Гадаю, навіть divs були RARE ( в ті дні IE був div і Netscape був layer) і виM SK1 були б LUCKY, якби ваші користувачі мали МSK2K зв 'язок. Отож я навчився оптимізувати МSK4 навіть такі речі, як мозакові фони для меню items ) і т.д.

Пізніше в Microsoft я навіть працював над автоматизованим інструментом для сканування зображення у веб-формах. - це було чудово : він витягнув малі зображення з сторінки МSK2 генерував CSS і зображення спіратора автоматично M SK3 Але, на жаль, , так само, як у моєму часі в Microsoft MSC5 це не повинно було бути МSK6

Коротко кажучи, це те, що я всю свою кар 'єру провела

Щоб бути чесним, ЦДН - це не зло,

Полне розголошення: Цей блог навмисно надмірно розроблений необхідність всю цю складність. Але будувати це таким чином дозволило мені вивчити сучасні фронтальні інструменти правильно і , вирішальним МSK2 дало мені щось справжнє, про що можна писати та навчати M SK3 Інколи найкращий спосіб навчитися - це побудувати щось трохи смішне і задокументувати подорож .

Проблема з CDN

Спочатку - МСК0 - мій підхід був простим - МSK1

<!-- Old CDN-based approach -->
<script src="https://unpkg.com/[email protected]/dist/cdn.min.js"></script>
<script src="https://unpkg.com/[email protected]"></script>
<script src="https://cdn.jsdelivr.net/npm/easymde/dist/easymde.min.js"></script>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/easymde/dist/easymde.min.css">

Це працює, але має декілька недоліків, які стають все більш розчаровуючими.

  • Проблеми надійності: CDNs таки знизуються . IM SK2 я бачив, що unpkg і jsdelivr мають вимкнення . Коли вони MSC4 знизились M SK5 ваша веб-страна зламана
  • Непередбачувана поведінка завантаження: Реакції ЦДН можуть різко змінюватися МSK1 Інколи швидко МSK2 інколи повільно , іноді вони вводять умови гонки, де бібліотеки загружаються в неправильному порядку
  • Проблеми часу: Ви не маєте контролю над тим, коли скрипти завантажуються відносно один одного . Це спричинило мені безкінечні головні болі після інициалізації бібліотеки
  • Багато HTTP запитів: Кожна бібліотека потребує окремого запиту, навіть з HTTPM SK2
  • Жодного дерева: Ви завантажуєте цілу бібліотеку , навіть якщо ви використовуєте лише частину її
  • Відхилення версії: ЦДН можуть працювати з різними версіями, якщо ви їх не прикріплюєте явно , і навіть прикріплені версії можуть поводитися по-різному в різних видах CDN
  • Збудувати-часова невизначеность: Ніяких способів виявити неповносправності до uruchomionego часу — часто, коли пользователь повідомляє про це
  • Ограничена оптимізація: Може ' не мінімізувати через кордони або видаляти мертвий код
  • Оффлайн розвиток: Потрібно підключення до ІнтернетуM SK1, що є неприємним при роботі на поїздах чи літаках

Тож я хотів контролювати...контроль того, що саме моя веб-страна використовувала і ЧТО мусить працюватиМSK1 Я хотів об 'єднати лише те, що мені потрібноM SK2 забезпечити надійний порядок завантаження, та оптимізувати ефективністьMSC4 Це означало відійти від CDN і перейти до підходу об' єднування .

Вони ' простіше встановлювати , і з HTTP МSK2 та HTTP \ /3 мультиплексування \ МSK4 численні накладні витрати є набагато менш критичними, ніж були раніше | МSK5 | Для багатьох проектів МSK6 особливо для маленьких або прототипів | , | ЦДН залишаються цілком розумним вибором |. | Але для виробничого майданчика, де я хотів контролювати , \ надійність \МSK10 \ і оптимізацію \мSK11 \ пакетування було більш логічно . \

Сучасний підхід до Bundling

Моє поточне налаштування об 'єднує всі JavaScript залежності через Webpack і об' єщує CSS через PostCSS.

Чому Webpack замість Vite?

Перед тим, як зануритися у технічні деталі, Я маю звернути увагу на слона в кімнаті : чому я користуюсь веб-пакетом, коли існує Vite, RollupM SK3 esbuildMSC4 і інші сучасні пакети?

Відповідь проста: Я вже знав Webpack.

Я широко використовував Webpack, коли викладав свій курс "Начальник веб-розробки " курс МSK3 і це було інструментом, який я зрозумів. Коли я вирішила модернізувати цей блогM SK5 конвейер будуванняMSC6 я вже зіткнулася з крутою кривою навчанняMska7 зрозуміння дереваMска8 розміщуванняМska9 розділення коду

Це, як правило, хороша практика при роботі над проектами.

Додаємо """, щоб навчитися абсолютно новому інструменту побудови, а ще "" МSK1 "", що здається непотрібним. "" концепції сучасного об 'єднання, а не ідіосинкратії певного інструмента.

Чи Vite швидший? Абсолютно . Vite ' розвиток сервера з нативними ES модулями і esbuild МSK2 потужне об 'єднання значно швидше, ніж Webpack МSK3 Для великих проектів із сотнями модулів

Чи варто використовувати Vite для нового проекту? Ймовірно, так . Якщо виM SK2 починаєте з нуля і не маєте' існуючих знань про Webpack, то Vite, швидше за все, кращий варіант.. Він(-а) МSK6 швидший(-е) МSK7 простіший для конфігурації, а також показує сучасний підхід до фронтального інструментарію.

Я шкодую за використання Webpack? Не зовсім. МСК0. Це привело мене туди, де я повинен був бути. МSK1. Уроки, які я вивчив про поєднання, ,. Розділ коду, МSK3. Оптимізацію можна перенести на будь-який інструмент будування.

Це - ключовий аспект того, як я створюю речі. Я починаю з того, що є EASY і будую на цьому фундаменті.

У цьому є ширший урок: прогрес переважає досконалість. Я міг би провести тижні на дослідженні найкращого пакету МСК1, МСК2, М СК3, порівнюючи показники МСК4, читаючи статті про порівняння МСК5 і мулячись через рішення МСК6. Натомість МСК7. Я вибрав інструмент, який я знав. МСК8. Зробив його дієвим. МТК9. І рухався вперед. ММК10. Цей прагматизм змусив мене працювати, а не безкінечно міркувати

Можливо, одного дня я міг би переїхати до Vite. Можливо, я вигравМSK1tM SK2 В будь-якому разі, цей блог має сучаснийMSC4 оптимізований конвеєр збудови, який працює надійно МSK5 і цеMСК6 це те, що має значенняМСК7

Структура пакету

І package.json тепер зберігає дві різні групи залежності. Ця структура зайняла мене кілька спроб, щоб отримати правильне —initiallyM SK2 Nuget і npm схожі на KINDA, але nppm набагато менш дружній, коли додаєш pacakges.

{
  "dependencies": {
    //NOTE - This is a pre-release of these enhancements, the 1.0.0 release is OUT NOW!
    "@mostlylucid/mermaid-enhancements": "^1.0.0-alpha0",
    "alpinejs": "^3.14.1",
    "codemirror": "5.65.13",
    "core-js": "^3.39.0",
    "easymde": "2.20.0",
    "flatpickr": "^4.6.13",
    "highlight.js": "^11.10.0",
    "highlightjs-cshtml-razor": "^2.1.1",
    "html-to-image": "^1.11.13",
    "htmx.org": "^2.0.1",
    "mermaid": "^11.0.2",
    "regenerator-runtime": "^0.14.1",
    "svg-pan-zoom": "^3.6.2"
  },
  //These are just used for build; not needed to RUN the app so we have a separate place for 'em
  "devDependencies": {
    "@babel/core": "7.26.9",
    "@babel/preset-env": "7.26.9",
    "@tailwindcss/aspect-ratio": "^0.4.2",
    "@tailwindcss/forms": "^0.5.7",
    "@tailwindcss/typography": "^0.5.12",
    "autoprefixer": "10.4.21",
    "babel-loader": "10.0.0",
    "cpx": "1.5.0",
    "css-loader": "7.1.2",
    "cssnano": "7.0.6",
    "daisyui": "^4.12.10",
    "mini-css-extract-plugin": "^2.9.4",
    "npm-run-all": "4.1.5",
    "postcss": "8.5.3",
    "postcss-cli": "11.0.1",
    "postcss-import": "^16.1.0",
    "rimraf": "6.0.1",
    "style-loader": "4.0.0",
    "tailwindcss": "3.4.17",
    "terser-webpack-plugin": "^5.3.10",
    "webpack": "^5.91.0",
    "webpack-cli": "^5.1.4"
  }
}

Відлежність потрібні в часі запуску. (AlpineM SK1js, HTMX , EasyMDEMSC4 і т.д. devDependencies є інструментами для побудови (WebpackM SK1 Babel, PostCSS процесориMSC3 і т.д.

Збудувати skriptи

І package.json сценарії значно розвивалися:

{
  "scripts": {
    "clean": "rimraf ./.tmp ./wwwroot/css/dist ./wwwroot/js/dist",
    "copy:static": "cpx \"src/css/{raleway,easymde-overrides}.css\" \"wwwroot/css/dist\"",
    "copy:highlight": "cpx \"src/css/highlight/*.min.css\" \"wwwroot/css/highlight\"",
    "copy:all": "npm-run-all --parallel copy:static copy:highlight",
    "copy:watch": "cpx \"src/css/{raleway,easymde-overrides}.css\" \"wwwroot/css/dist\" --watch & cpx \"src/css/highlight/*.min.css\" \"wwwroot/css/highlight\" --watch",
    "tw:dev": "postcss ./src/css/main.css -o ./wwwroot/css/dist/main.css",
    "tw:prod": "postcss ./src/css/main.css -o ./wwwroot/css/dist/main.css --no-map --verbose",
    "tw:watch": "postcss ./src/css/main.css -o ./wwwroot/css/dist/main.css --watch",
    "js:dev": "webpack --env development",
    "js:prod": "webpack --mode production",
    "js:watch": "webpack watch --mode development",
    "dev": "npm-run-all clean --parallel copy:all tw:dev js:dev",
    "watch": "npm-run-all clean copy:all --parallel copy:watch tw:watch js:watch",
    "build": "npm-run-all clean copy:all --parallel tw:prod js:prod"
  }
}

Ця налаштування відокремлює проблеми:

  • очистити: Removes previous build outputs using rimraf
  • копія:* завдання: копіює статичні CSS-файли, які не потребують обробкиM SK1 МSK2 це або МSK3 импорти ') для спеціального призначення, наприклад, завантаження мого Funky шрифта Raleway, або адаптивних, таких як зміна тем, покращення
  • tw:* задачі: Процеси Tailwind CSS через PostCSS
  • js:* завдання: Bundles JavaScript through Webpack
  • dev/watch/build: Оркеструє весь канал

І npm-run-all пакет дозволяє паралельне виконання для швидших будівок.

Ви можете npm run build для автоматичної запуску під час вашого локального створення, але це' є трохи важким для CI M SK1 вам потрібно впевнитись, що це ' не працює і т.д.

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <SpaRoot>ClientApp\</SpaRoot>
  </PropertyGroup>

  <!-- Run npm install only when package.json changes -->
  <Target Name="NpmInstall" Inputs="$(SpaRoot)package.json" Outputs="$(SpaRoot)node_modules" BeforeTargets="Build">
    <Message Importance="high" Text="Running npm install in $(SpaRoot)" />
    <Exec WorkingDirectory="$(SpaRoot)" Command="npm ci" />
  </Target>

  <!-- Run npm build before the .NET build -->
  <Target Name="NpmBuild" DependsOnTargets="NpmInstall" BeforeTargets="Build">
    <Message Importance="high" Text="Running npm run build in $(SpaRoot)" />
    <Exec WorkingDirectory="$(SpaRoot)" Command="npm run build" />
  </Target>

</Project>

Щоб це зробити, просто додайте це до вашого csproj... Можна навіть сказати, що це працює тільки під час деbugу ' і т.д. npm run watch робить лише те, що коли будь-який css / js файл змінює його автоматично - запускає будову МSK3

NOTE: В світі JS вони майже використовують гарячі - перезавантаження dev запуски, які є досить гладкими і роблять вас трохи ненавидіти ASP

Konfiguracja Webpack Deep Dive

Конфигурація вебпакета - це місце, де відбувається магія— і де я проводив більшу частину мого часу, розв 'язуючи проблеми . Це не стало реальністю МSK2 не було повністю сформовано M SK3 Це – результат незліченних повторень , пошуки надлишку резервуарного потоку MSC6 і читання Webпакетної документації на MSSK7 я намагаюсь зрозуміти, чому мій зразок генерував МСК8 фрагменти файлів МSК9

Тут ' є теперішньою конфігурацією ( з webpack.config.js) з деталізованими поясненнями того, що робить кожна частина і чому вона є

const TerserPlugin = require('terser-webpack-plugin');
const path = require('path');

module.exports = (env, argv) => {
    const isProduction = argv.mode === 'production';

    return {
        mode: isProduction ? 'production' : 'development',
        entry: {
            main: './src/js/main.js',
        },
        output: {
            filename: '[name].js',
            chunkFilename: '[name].[contenthash].js',
            path: path.resolve(__dirname, 'wwwroot/js/dist'),
            publicPath: '/js/dist/',
            module: true,
            clean: true,
        },
        experiments: {
            outputModule: true,
        },
        module: {
            rules: [
                {
                    test: /\.css$/i,
                    use: ['style-loader', 'css-loader'],
                },
                {
                    test: /\.js$/,
                    exclude: /node_modules/,
                    use: {
                        loader: 'babel-loader',
                        options: {
                            presets: [
                                ['@babel/preset-env', {
                                    targets: '> 0.25%, not dead',
                                    modules: false,
                                    useBuiltIns: 'usage',
                                    corejs: 3,
                                }],
                            ],
                        },
                    },
                },
            ],
        },
        resolve: {
            extensions: ['.js', '.mjs'],
            alias: {
                '@mostlylucid/mermaid-enhancements$': path.resolve(__dirname, 'node_modules/@mostlylucid/mermaid-enhancements/dist/index.min.js')
            }
        },
        optimization: {
            splitChunks: {
                chunks: 'all',
                minSize: 20000,
                maxSize: 100000,
                name: false,
            },
            runtimeChunk: {
                name: 'runtime',
            },
            minimize: isProduction,
            minimizer: isProduction ? [
                new TerserPlugin({
                    terserOptions: {
                        ecma: 2020,
                        compress: {
                            drop_console: true,
                            passes: 3,
                            toplevel: true,
                            pure_funcs: ['console.info', 'console.debug'],
                        },
                        mangle: {
                            toplevel: true,
                        },
                        format: {
                            comments: false,
                        },
                    },
                    extractComments: true,
                }),
            ] : [],
        },
        devtool: isProduction ? false : 'eval-source-map',
        performance: {
            hints: isProduction ? 'warning' : false,
        }
    };
};

Пояснення основних секцій конфігурації

Розподіл коду та відтворення коду

optimization: {
    splitChunks: {
        chunks: 'all',
        minSize: 20000,
        maxSize: 100000,
        name: false,
    },
    runtimeChunk: {
        name: 'runtime',
    },
}

Ця конфігурація автоматично розділяє ваш код на менші шматочки:

  • шматочки: 'всеM SK2: Анализує і синхронний, і асинхронний импорт
  • MinSize: M SK1: Створює лише фрагменти для модулів більших за 20KB
  • MaxSize: M SK1: Намагання розділити фрагменти, більші за 100KB
  • runtimeChunk: Extracts Webpack runtime into a separate file to improve long

У практиці, це генерує багато файлів в wwwroot/js/dist/:

  • main.js - Ваш вхідний пункт для заявок
  • runtime.js - Логіка завантаження модуля Webpack
  • [vendor].[contenthash].js - Автоматично розділяють шматочки продавця
  • Dodatkowі шматочки для коду-розривні маршрути або лінивіM SK1завантаження модулів

Перетворення Babel

{
    test: /\.js$/,
    exclude: /node_modules/,
    use: {
        loader: 'babel-loader',
        options: {
            presets: [
                ['@babel/preset-env', {
                    targets: '> 0.25%, not dead',
                    modules: false,
                    useBuiltIns: 'usage',
                    corejs: 3,
                }],
            ],
        },
    },
}

Babel перетворює сучасний JavaScript для obsługi старших браузерів:

  • ціль: Obsługує браузери з ринковим udziałом >0.25%, які досі підтримують
  • модулі: неправильні: Захищає модулі ESM SK1 для дерева Webpack
  • використовуватиBuiltIns: M SK1usage': автоматично включає в себе поліформи лише для ваших завдань
  • corejs: M SK1: Кораїна

Це означає, що я можу написати сучасний JavaScript (асинк /await МSK2 опційне відслідковування МSK3 нульове злиття мSK4 підтримуючи ширу підтримку веб-браузера M.

Миніфікація виробництва

minimizer: isProduction ? [
    new TerserPlugin({
        terserOptions: {
            ecma: 2020,
            compress: {
                drop_console: true,
                passes: 3,
                toplevel: true,
                pure_funcs: ['console.info', 'console.debug'],
            },
            mangle: {
                toplevel: true,
            },
            format: {
                comments: false,
            },
        },
        extractComments: true,
    }),
] : []

Терсер агресивно зменшує виробництво будівель

  • Drop_консоль: Виключає все console.log() заяви
  • проходи: M SK1: Триразово приштовхується, щоб зменшити розмір
  • верхній рівень: правда: Назви змінних рівня
  • чистий_funcs: Виключає певні методи консолі, навіть якщо вони приpisanі змінним
  • коментарі: хибно: Стирає всі коментарі з вихідного коду

На цьому блогі, це, як правило, зменшує розміри пакетів JavaScript на 60-70% порівняно з невичерпаним кодом МSK2

Піплін PostCSS для Tailwind

Tailwind CSS обробляється за допомогою PostCSS з багатьма плагинами. Ця конфігурація (from postcss.config.js) дуже простий, порівняно з Webpackом

// postcss.config.js
module.exports = {
    plugins: {
        'postcss-import': {},
        tailwindcss: {},
        autoprefixer: {},
        cssnano: { preset: 'default' }
    }
}

Трубопровод працює так::

  1. Postcss-введення: Вирішує @import твердження в файлах CSS
  2. tailwindcss: Обробляє інструкції Tailwind і генерує класи засобів
  3. автоматичний префиксатор: Додає префиксів продавця для здатності переглядати браузер
  4. cssnano: Miniфікує кінцевий вихід CSS

Konfiguracja Tailwind

І tailwind.config.js файл визначає, де Tailwind повинен шукати імена класів. Дослідження content шляхи справа були критичними—miss a path and Tailwind wonM SK1t generate classes for those files:

module.exports = {
    content: ["./Views/**/*.cshtml", "./EmailSubscription/**/*.cshtml"],
    safelist: ["dark", "light"],
    darkMode: "class",
    theme: {
        fontFamily: {
            body: ["Raleway", "sans-serif"],
        },
        extend: {
            colors: {
                "custom-light-bg": "#ffffff",
                "custom-dark-bg": "#1d232a",
                primary: "#072344",
                secondary: "#00aaa1",
                // ... more custom colours
            },
        },
    },
    plugins: [
        require("@tailwindcss/aspect-ratio"),
        require("@tailwindcss/typography"),
        require("daisyui"),
    ],
};

Головні характеристики:

  • зміст: Сканування .cshtml файли для назви класи (включно з розорними widokами та шаблонами для листівM SK1
  • список безпеки: Включає ці класи, навіть якщо їх не знайдено в скануванні
  • темнийMode: МSK1класM SK2: Дасть можливість переключення в темний режим, заснований на класіM SK1
  • тема.виширити: Додає на замовлення кольори та значення простору
  • плагини: включає в себе плагини Tailwind та базу komponentів DaisyUI

Tailwind сканує ці файли під час створення, використовуючи лише класи, які ви насправді використовуєтеM SK1 Ось чому кінцевий CSS-файл набагато менший за повну бібліотеку Tail Wind.

JavaScript - це точка входу

І main.js файл - це місце, де все об 'єднується.

// src/js/main.js
import hljsRazor from "highlightjs-cshtml-razor";
import mermaid from "mermaid";
import Alpine from 'alpinejs';
import htmx from "htmx.org";
import hljs from "highlight.js";
import EasyMDE from "easymde";
import 'easymde/dist/easymde.min.css';
import flatpickr from "flatpickr";
import 'flatpickr/dist/flatpickr.min.css';

// Expose libraries globally for Razor views
window.Alpine = Alpine;
window.hljs = hljs;
window.htmx = htmx;
window.mermaid = mermaid;
window.EasyMDE = EasyMDE;
window.flatpickr = flatpickr;

// Import custom modules
import { typeahead } from "./typeahead";
import { submitTranslation, viewTranslation } from "./translations";
import { codeeditor } from "./simplemde_editor";
import { globalSetup } from "./global";
import { comments } from "./comments";

// Attach to namespace
window.mostlylucid = window.mostlylucid || {};
window.mostlylucid.typeahead = typeahead;
window.mostlylucid.comments = comments();
window.mostlylucid.translations = {
    submitTranslation: submitTranslation,
    viewTranslation: viewTranslation
};

// Initialise Alpine
Alpine.start();

Цей підхід дає декілька переваг:

  1. Єдина точка ввозу: Усі залежності завантажені через один файл запису
  2. Виражені версії: УпаковкаM SK1 json замика специфічні версії
  3. Tree-Shaking: Вебпак removes unused code from libraries
  4. Глобальна експозиція: Libraries available to Razor views via window
  5. За замовчанням: ЗастосунокM SK1конкретний код, організований на ввозні модулі

Інтеграція шаблонівレイアウトу

В _Layout.cshtml, Зараз я маю на увазі лише пакетні активиM SK1

<head>
    <link href="/css/dist/main.css" asp-append-version="true" rel="stylesheet" />
</head>
<body>
    <!-- Content -->
    <script src="~/js/dist/main.js" type="module" asp-append-version="true"></script>
</body>

Примітка, яку я визначив module щоб повідомити браузеру, який тип файла JS це & asp-append-version гарний маленький ASP.NET вказівник-помічник, що додає хашедну версію контенту файла до строку запиту

Єдине, що залишається від CDN - це:

  • Зарегистрируйтесь в Google: Потрібний зовнішній CDN для OAuth
  • Боксикони: Іконний шрифт МSK1 міг би бути об 'єднаний МSK2 але мали б мінімальну користь
  • Умамі Аналітика: Третій МSK1 сторонній скрипт аналітики МSK2 самогосударований, тож я бачу ваш візит не в Google ??

Збудувати візуалізацію трубопроводу

Ось як весь процес побудови рухається від вихідних файлів до виробничих активів.

graph TD
    A[Source Files] --> B[npm run build]
    B --> C[Clean Task]
    C --> D[rimraf wwwroot/css/dist wwwroot/js/dist]

    B --> E[Copy Task]
    E --> F[cpx: Copy static CSS files]
    F --> G[wwwroot/css/dist/raleway.css]
    F --> H[wwwroot/css/dist/easymde-overrides.css]

    B --> I[Tailwind Task]
    I --> J[PostCSS Pipeline]
    J --> K[postcss-import]
    K --> L[Tailwind CSS]
    L --> M[Autoprefixer]
    M --> N[cssnano]
    N --> O[wwwroot/css/dist/main.css]

    B --> P[Webpack Task]
    P --> Q[Entry: src/js/main.js]
    Q --> R[Babel Transpilation]
    R --> S[Module Resolution]
    S --> T[Tree Shaking]
    T --> U[Code Splitting]
    U --> V[Terser Minification]
    V --> W[wwwroot/js/dist/main.js]
    V --> X[wwwroot/js/dist/runtime.js]
    V --> Y[wwwroot/js/dist/vendor chunks]

    O --> Z[ASP.NET Core Static Files]
    W --> Z
    X --> Z
    Y --> Z
    G --> Z
    H --> Z

    Z --> AA[Browser]

    style A stroke:#0ea5e9,stroke-width:3px
    style Z stroke:#f59e0b,stroke-width:3px
    style AA stroke:#10b981,stroke-width:3px

Виглядає досить складно, але насправді - це те, що робить WebPack. МСК1 - він сам займається цим. МSK2 - таким складним способом, якого не потребують такі люди як Vite.

Поліпшення ефективності

Знову ж таки, не дійсно POINTM SK1 Але тепер він завантажується як абсолютний пульт. Ви все ще можете отримати проблеми з Cloudflare 's МSK4Rocket Loader MSC5 M SK6 що трохи погіршує процес завантаження сторінок ) але цеMSC8sTIGHTМSK9

Допомоги для розробників

За межами ефективності, сучасна конвеєра збудови значно покращує процес розробкиM SK1

Тип Безпеки та IntelliSense

Об 'єднання за допомогою Webpack дає змогу отримати правильну роздільну здатність модуля JavaScript, що означаєM SK1

  • IntelliSense в коді VS: АвтоM SK1завершення для ввезених модулів
  • Перейти до визначення: Навігати прямо до вихідного коду бібліотеки
  • Інлайнова документація: Комментари JSDoc з бібліотек з 'являються в IDE

Коли будівля руйнується ( з npm run watch) Я знаю, що миттєво , в połączeniu з МSK2 мало, але зростає МSK3 тести на одиниці ДС означає міцніший зворотній зв 'язок M SK4

Заміна гарячого модуля

Під час розробки, npm run watch дозволяє майже- миттєвий зворотній зв 'язокM SK1

npm run watch

Це запускає Webpack у режимі годинника, перебудування лише змінних модулівM SK1

  • Типове перебудування часуМSK0 200-400м
  • Автоматичний перегляд браузера-заново: Використовуючи браузер
  • Утримований стан застосування: HMR підтримує стан aplikacji під час оновлення

Керування залежністю

npm's lock file (package-lock.json) гарантує послідовні конструкції в різних середовищах :

npm ci  # Clean install from lock file

Це гарантує однакові версії залежності у розробці, CI/CDM SK2 і в виробничому середовищі .

Вони називаються 'pinning' в світі JSM SK2 де відлежності закріплені в кам 'яні . Ви можете зробити це без замка пакету, але тоді виMSC4 залежать від авторів pacakge МSK5 часто Сотні різних людей, не screwing up some minor release

Збудувати skriptи

Організовані сценарії npm роблять звичайні завдання легкими:

npm run dev      # One-time development build
npm run watch    # Continuous development builds
npm run build    # Production build with optimisations
npm run clean    # Remove build artefacts

Зазвичайні моделі та рішення

Виставляння об 'єднаних бібліотек по всьому світу

Деякі бібліотеки потребують глобального відображання для використання в розорних widokах або інлайн-скриптах:

// Make library available globally
import Alpine from 'alpinejs';
window.Alpine = Alpine;
Alpine.start();

А потім .cshtml файли:

<div x-data="{ open: false }">
    <!-- Alpine.js works because it's on window -->
</div>

Керування CSS з модулів JavaScript

Деякі бібліотеки містять CSS, який потребує введення:

import EasyMDE from "easymde";
import 'easymde/dist/easymde.min.css';  // Imported CSS is processed by Webpack

Вебпакет's css-loader і style-loader керувати цим импортом:

  • CSS виділяється під час будування
  • Вживають на сторінку через <style> ярлики або окремі CSS-файли
  • Автоматично прикріплені і зменшені

Неохоче завантажують важкі бібліотеки

Для бібліотек, які потрібні лише на конкретних сторінках, використовувати динамічні введенняM SK1

// Only load Mermaid when needed
async function initMermaid() {
    const mermaid = await import('mermaid');
    mermaid.default.initialize({ startOnLoad: true });
}

// Call when needed
if (document.querySelector('.mermaid')) {
    initMermaid();
}

Вебпакт автоматично кодує- розділяє динамічні введення на окремі шматочкиM SK1 завантажений на -заказ

Працювати з модулями CommonJS

Деякі старі бібліотеки використовують CommonJS замість модулів ES6

// CommonJS require syntax
const hljs = require('highlight.js');

// Or use dynamic import
import('highlight.js').then(hljs => {
    // Use hljs
});

Вебпак регулює обидві модулі системами прозоро, перетворення CommonJS на ES

Полегшення поширених проблем

Źródлові карти, які не є в розробці

Упевнитись devtool підключений до webpack.config.js:

devtool: isProduction ? false : 'eval-source-map',

Це генерує вихідні карти у розробці для легшого виправлення.

Проблеми очистки класу CSS з Tailwind

Якщо Tailwind видаляє класи, які ви використовуєте content налаштування:

// tailwind.config.js
module.exports = {
    content: [
        './Views/**/*.cshtml',
        './Components/**/*.cshtml',
        // Add any other paths where classes are used
    ],
}

Або ж, використовувати safelist для динамічних классов:

safelist: [
    'bg-blue-500',
    'text-red-600',
    {
        pattern: /bg-(red|green|blue)-(400|500|600)/,
    }
]

Module Not Found Errors

Якщо Webpack не здатний' розв 'язати модуль, перевіритиM SK2

  1. Викоректувати шлях введення: Відносні шляхи починаються з ./ або ../
  2. Поширення файлів: Dodaj .mjs до resolve.extensions якщо необхідно
  3. Алізії: Використовувати resolve.alias для складних шляхів
resolve: {
    extensions: ['.js', '.mjs', '.json'],
    alias: {
        '@components': path.resolve(__dirname, 'src/js/components/'),
    }
}

Побудувати проблеми ефективності

Якщо будування повільне:

  1. Включити кэшування: Webpack ' Cache значно пришвидшує перебудову
  2. Скорінити масштаб Babel: Виключити більше директорій з обробки Babel
  3. Обновлення інструментів: Нові версії Webpack і Babel швидші
  4. Паралельні будинки: Використовувати thread-loader для транспліту Multi-
// Enable Webpack caching
cache: {
    type: 'filesystem',
},

Уроки, отримані важко

Дозвольте поділитися деякими помилками, які я зробила на цьому шляху.

Помилка #1: Намагання об 'єднати все одночасно

Мій перший спроба полягала в відриві всіх CDN-референцій в один раз і спробі об 'єднати все за допомогою Webpack. Збудова провалилась неймовірноM SK1 Я зрозумів, що інкрементальна міграція - це ваш друг — переміщувати одну бібліотеку в один час

помилка #2: Не розуміємо типів модуля

Я марнував годинами, намагаючись зрозуміти, чому деякі бібліотеки не завантажують.require()Модулі ) та ESM SK1 (import) без усвідомлення того, як Webpack їх обробляє, призводить до криптичних помилок experiments: { outputModule: true } конфігурація була "'", в моїй першій настановці МSK1 , і я не міг "'", не зміг зрозуміти, чому мої модулі не .

Рішення з 'явилось після перегляду проблем на GitHub у репозитори Webpack в півночі.

Ошибка #3: За МSK1Агресивне розщеплення коду

В певний момент – , – моя конфігурація генерувала кусочки для всього. minSize: 10000 (10KBM SK1 що означало, що Webpack створював окремі файли для невеликих утимунітарних функцій . перехрещений МSK3 виправив і перейшов до МSK4 МБ МСК5 Завантаження сторінки стало водоспадом requests for small chunk or hung waiting for huge chunks to download minSize: 20000 МSK0KB).

помилка #4: Забуття про .mjs Поширення

Деякі пакети npm розповсюджують модулі ES6 .mjs rozszerzenie. Webpack won' не вирішує їх по замовчуваннюM SK2 Я витратив дуже багато часу на виправлення @mostlylucid/mermaid-enhancements Would' not load before discovering I needed to add .mjs до resolve.extensions.

Прості рішення, як тільки ви знаєте це, але знаходити, що herausM SK1 Це зайняло багато часу .

Ошибка #5: Не за Caching Webpack Buildings

Перші будування зайняли 30-60 секунди, тому що я не мав ' ввімкнутого вебпакета МSK2 файлового системного кэша МSK3 Як тільки я додав кэшу \ , часи перебудови знизились до \2-3 секунд \ МSK6 \ Це була гра \ - \ Цифрова програма для розробки, але знадобилося кілька тижнів, щоб її відкрити

Ошибка #6: Tailwind очищування класів, які я насправді використовував

Мій улюблений досвід розладів: класи CSS, які добре працювали у розробці, несподівано зникли в процесі виробництваM SK1 Tailwind вичистив їх, тому що вони були генеровані динамічно в JavaScript. Рішенням було safelist конфігурація, але тільки після того, як я Я теж (, наприклад, в mostlylucid.pagingtaghelper проект) використовувати M SK1 тупі блоки ' де я упроможюю свої зміни на конфігурації Tailwind лише за допомогою прихованого блоку


<!--
    Preserve Tailwind & DaisyUI classes used in embedded pager views.
    Without this, TailwindCSS tree-shaking removes classes from the embedded library views.
-->
<span class="hidden
    btn btn-sm btn-active btn-disabled join join-item badge badge-sm select select-bordered select-sm label label-text
    px-3 py-2 py-1 text-sm font-medium border rounded whitespace-nowrap cursor-not-allowed
    text-gray-700 text-gray-600 text-gray-400 text-white bg-white bg-gray-100 bg-blue-600 border-gray-300 border-blue-600
    hover:bg-gray-50 hover:bg-blue-700
    dark:bg-gray-800 dark:bg-gray-700 dark:bg-blue-500 dark:text-gray-300 dark:text-gray-500 dark:text-gray-200
    dark:border-gray-600 dark:border-blue-500 dark:hover:bg-gray-700 dark:hover:bg-blue-600">
</span>

Коли Tailwind будує, він сканує cshtml-файли для класів; якщо він їх не бачить ' він їх видаляє M SK2 Таким чином, цей прихований блок гарантує, що він бачить ті класи, які мені потрібні, навіть якщо вони МSK3 є лише застосовані у вбудованих Ansichtах Бібліотеки


module.exports = {
content: ["./Views/**/*.cshtml", "./EmailSubscription/**/*.cshtml"],
-//^^^^ This is what Tailwing knows where to look for classes duritng the tree Shake. 
+//^^^^ This is what Tailwind knows where to look for classes during the tree-shake.
  
  ...

future: {...}

}

Як вже згадано, підходом 'Tailwind Approved' є доdanie класів до списку безпеки ... але я МSK4 я ASP МSK5 NET хлопець \ , \ так що HTML виграв \ МSK7 \

Що я отримав правильно: Простійність

Одна з речей, яку я зробила правильно, це була відмовитися від здатися. МСК0. Кожна інформація про помилки - це можливість навчитися. МSK1. Кожне поламане будування навчило мене чомусь новому про те, як працюють ці інструменти. .. У мене була чітка wizія.

Завершення

Миграція з CDN-залежності на сучасний конвеєр пакетування була трансформаційною для цього блогу , але це було нелегко МSK2M SK3 покращення ефективності суттєві МСК4 досвід разработчиків значно кращий MСК5 і я маю набагато більший контроль над оптимізацією М СК6но знадобилося кілька місяців проб та помилок, щоб дістатися сюди M СК7

Key takeaways:

  1. Об 'єднання зменшує розмір вантажу: ДеревоM SK1 видіння та вичерпання eliminують непотрібний код
  2. Розділ коду покращує ефективність: Переglądачі завантажують тільки те, що потрібно
  3. Збудувати інструменти, які дають змогу використовувати сучасний JavaScript: Перетворення Babel підтримує найновіші мовні характеристики, водночас зберігаючи совместність з браузером
  4. Трубопровод PostCSS оптимізує CSS: Tailwind's компілятор JIT і cssnano додають крихітні таблички стилю
  5. Інтеграція з .NET безшовна: Цілі MSBuild автоматично запускають фронтальні будинки
  6. Упертість перемагає досконалість: Ви не маєте ' вам не потрібно бути фахівним експертом МSK2 вам лише потрібна чітка бачення і бажання повторювати

Для ASP. NET Core програмісти, які звикли до простого CDN, включають: , це здається приголомшливим на перший погляд M SK2 те, що МSK3 нормальній МSK4 я почувався так само, як і МSK5 розпочати маленьке , мігрувати одну залежність в один раз MSC7 та не боятися зламати речі у розробці MSL9 Ви MKL10 навчитесь більше, використовуючи зламані будинки, ніж ви коли-небудь зрозумієте, читаючи документацію MCL11

Конфигурація, яку я поділився з вами тут - це місяці повторення. МСК1 - Ваша подорож буде іншою. МSK2 - це добре. ММК3 - це хороше. ММСК4 - використайте це як точку розпочинки. МСМ5 - не Евангелія. ММБ6 - пристосуйте її до ваших потреб. ММП7 - експеримент. ММН8 - не відхиляйтесь від невдач. МMP10 - вони - частина процесу.

Чи цей блог надмірно розроблений? Absolutely. Я міг би продовжувати використовувати CDN і витрачати свій час на інші речі ? Звісно, МSK2 Але я б не вчився МSK3 не вивчив половини того, що у МSK4 і не мав б цього статті поділитися з вами M SK6 Іноді надмірна інженерія - це не про кінцевий пункт, а те, що ти вчишся на цьому шляху та можеш навчити інших з цього досвіду .

Якщо ви' все ще спираєтеся на CDN для ваших фронтальних віддаленостей ( frontend dependencies), я заохочую вас спробувати об 'єднати пакети.. Почнемо з однієї бібліотеки, .. Подивіться, як це виглядає. МSK4. Звідси повторюємось. .. Ekoсистема значно виросла.

Дальне читання

logo

© 2026 Scott Galloway — Unlicense — All content and source code on this site is free to use, copy, modify, and sell.