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

<datetime class="hidden">2025-11-11T02:15</datetime>

<!-- category -- ASP.NET, Tailwind, Webpack, Frontend -->
## Введение

Протягом минулого року – МСК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 Інколи найкращий спосіб навчитися - це побудувати щось трохи смішне і задокументувати подорож .

[TOC]

## Проблема з CDN

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

```html
<!-- Old CDN-based approach -->
<script src="https://unpkg.com/alpinejs@3.x.x/dist/cdn.min.js"></script>
<script src="https://unpkg.com/htmx.org@2.x.x"></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`](https://github.com/scottgal/mostlylucidweb/blob/main/Mostlylucid/package.json) тепер зберігає дві різні групи залежності. Ця структура зайняла мене кілька спроб, щоб отримати правильне —initiallyM SK2 Nuget і npm схожі на KINDA, але nppm набагато менш дружній, коли додаєш pacakges.

```json
{
  "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` сценарії значно розвивалися:

```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 вам потрібно впевнитись, що це ' не працює і т.д.

```xml
<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`](https://github.com/scottgal/mostlylucidweb/blob/main/Mostlylucid/webpack.config.js)) з деталізованими поясненнями того, що робить кожна частина і чому вона є

```javascript
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,
        }
    };
};
```

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

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

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

```javascript
{
    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.

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

```javascript
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`](https://github.com/scottgal/mostlylucidweb/blob/main/Mostlylucid/postcss.config.js)) дуже простий, порівняно з Webpackом

```javascript
// 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`](https://github.com/scottgal/mostlylucidweb/blob/main/Mostlylucid/tailwind.config.js) файл визначає, де Tailwind повинен шукати імена класів. Дослідження `content` шляхи справа були критичними—miss a path and Tailwind wonM SK1t generate classes for those files:

```javascript
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`](https://github.com/scottgal/mostlylucidweb/blob/main/Mostlylucid/src/js/main.js) файл - це місце, де все об 'єднується.

```javascript
// 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

```html
<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 ??

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

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

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

```bash
npm run watch
```

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

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

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

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

```bash
npm ci  # Clean install from lock file
```

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

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

### Збудувати skriptи

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

```bash
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ах або інлайн-скриптах:

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

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

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

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

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

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

```javascript
// 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

```javascript
// 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`:

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

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

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

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

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

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

```javascript
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` для складних шляхів

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

```javascript
// 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 лише за допомогою прихованого блоку

```html

<!--
    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ах Бібліотеки

```json

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система значно виросла.

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

- [Документація Webpack](https://webpack.js.org/)
- [Tailwind CSS: Оптимізація для виробництва](https://tailwindcss.com/docs/optimizing-for-production)
- [Бабель: Довідник про використання](https://babeljs.io/docs/en/usage)
- [Дослідження PostCSS](https://postcss.org/)
- [Мій попередній artykuł: Tailwind для ASP.NET Core Developers](/blog/tailwind)