Параметры сборки

build.target

Тип: string | string[]
По умолчанию: 'modules'
Связанный: Browser Compatibility

Цель совместимости браузера для окончательного пакета. Значением по умолчанию является специальное значение Vite, 'modules', предназначенное для браузеров с нативными модулями ES, нативным динамическим импортом ESM, и import.meta.

Другое специальное значение — 'esnext' — предполагает встроенную поддержку динамического импорта и будет транспилировать как можно меньше:

Если параметр build.minify имеет значение 'terser', 'esnext' будет принудительно уменьшен до 'es2021'.
В других случаях он вообще не будет выполнять транспиляцию.

Преобразование выполняется с помощью esbuild, и значение должно быть допустимым опция цели esbuild. Настраиваемыми целями могут быть версия ES (например, es2015), браузер с версией (например, chrome58) или массив из нескольких целевых строк.

Обратите внимание, что сборка завершится ошибкой, если код содержит функции, которые нельзя безопасно перенести с помощью esbuild. Подробнее смотрите в документации esbuild.

build.modulePreload

Тип: boolean | { polyfill?: boolean, resolveDependencies?: ResolveModulePreloadDependenciesFn }
По умолчанию: true

По умолчанию автоматически внедряется модуль предварительной загрузки полифилла. Полифилл автоматически внедряется в прокси-модуль каждой записи index.html. Если сборка настроена на использование пользовательской записи, отличной от HTML, через build.rollupOptions.input, необходимо вручную импортировать полифилл в вашу пользовательскую запись:

Следует ли автоматически вводить модуль предварительной загрузки полифилл.

Если установлено значение true, полифилл автоматически внедряется в прокси-модуль каждой записи index.html. Если сборка настроена на использование пользовательской записи, отличной от HTML, через build.rollupOptions.input, необходимо вручную импортировать полифилл в вашу пользовательскую запись:

import 'vite/modulepreload-polyfill'

Примечание: Полифилл не применяется к режиму библиотеки. Если вам нужно поддерживать браузеры без собственного динамического импорта, вам, вероятно, следует избегать его использования в вашей библиотеке.

Полифилл можно отключить с помощью { polyfill: false }.

Список фрагментов для предварительной загрузки для каждого динамического импорта вычисляется Vite. По умолчанию при загрузке этих зависимостей будет использоваться абсолютный путь, включая base. Если base является относительной ('' или './'), import.meta.url используется во время выполнения, чтобы избежать абсолютных путей, которые зависят от конечной развернутой базы.

Существует экспериментальная поддержка тонкого управления списком зависимостей и их путями с помощью функции resolveDependencies. Ожидается функция типа ResolveModulePreloadDependenciesFn:

type ResolveModulePreloadDependenciesFn = (
  url: string,
  deps: string[],
  context: {
    importer: string
  }
) => (string | { runtime?: string })[]

Функция resolveDependencies будет вызываться для каждого динамического импорта со списком фрагментов, от которых он зависит, а также будет вызываться для каждого фрагмента, импортируемого в входных HTML-файлах. Новый массив зависимостей может быть возвращен с этими отфильтрованными или несколькими введенными зависимостями и измененными путями к ним. Пути deps относятся к build.outDir. Возврат относительного пути к hostId для hostType === 'js' разрешен, и в этом случае new URL(dep, import.meta.url) используется для получения абсолютного пути при внедрении предварительной загрузки этого модуля. в заголовке HTML.

modulePreload: {
  resolveDependencies: (filename, deps, { hostId, hostType }) => {
    return deps.filter(condition)
  }
}

Разрешенные пути зависимостей можно дополнительно изменить с помощью experimental.renderBuiltUrl.

build.polyfillModulePreload

Тип: boolean
По умолчанию: true
Устарело вместо этого используйте build.modulePreload.polyfill Следует ли автоматически вводить module preload polyfill.

build.outDir

Тип: string
По умолчанию: dist

Укажите выходной каталог (относительно корень проекта).

build.assetsDir

Тип: string
По умолчанию: assets

Укажите каталог для вложения сгенерированных ресурсов (относительно build.outDir).

build.assetsInlineLimit

Тип: number
По умолчанию: 4096 (4kb)

Импортированные ресурсы или ресурсы, на которые есть ссылки, размер которых меньше этого порога, будут встроены как URL-адреса base64, чтобы избежать дополнительных HTTP-запросов. Установите 0, чтобы полностью отключить встраивание.

Заполнители Git LFS автоматически исключаются из встраивания, поскольку они не содержат содержимого файла, который они представляют.

Примечание

Если вы укажете build.lib, build.assetsInlineLimit будет игнорироваться, а активы всегда будут встроенными, независимо от размера файла или быть заполнителем Git LFS.

build.cssCodeSplit

Тип: boolean
По умолчанию: true

Включить/выключить разделение кода CSS. Если этот параметр включен, CSS, импортированный в асинхронные фрагменты, будет встроен в сам асинхронный фрагмент и вставлен при его загрузке.

Если этот параметр отключен, все CSS во всем проекте будут извлечены в один файл CSS.

Примечание

Если вы укажете build.lib, build.cssCodeSplit будет по умолчанию false.

build.cssTarget

Тип: string | string[]
По умолчанию: то же, что и build.target

Этот параметр позволяет пользователям установить другую цель браузера для минификации CSS, отличную от той, которая используется для транспиляции JavaScript.

Его следует использовать только в том случае, если вы ориентируетесь на неосновной браузер. Одним из примеров является Android WeChat WebView, который поддерживает большинство современных функций JavaScript, но не поддерживает #RGBA шестнадцатеричное обозначение цвета в CSS. В этом случае вам нужно установить для build.cssTarget значение chrome61, чтобы vite не преобразовывал цвета rgba() в шестнадцатеричные обозначения #RGBA.

build.sourcemap

Тип: boolean | 'inline' | 'hidden'
По умолчанию: false

Создавайте исходные карты производства. Если true, будет создан отдельный файл исходной карты. Если 'inline', исходная карта будет добавлена к результирующему выходному файлу как URI данных. 'hidden' работает так же, как true, за исключением того, что соответствующие комментарии исходной карты в связанных файлах подавляются.

build.rollupOptions

Тип: RollupOptions

Непосредственно настраивайте базовый пакет Rollup. Это то же самое, что и параметры, которые можно экспортировать из файла конфигурации Rollup, и они будут объединены с внутренними параметрами Rollup Vite. Дополнительные сведения см. в Документация по вариантам Rollup.

build.commonjsOptions

Тип: RollupCommonJSOptions

Параметры для перехода к @rollup/plugin-commonjs.

build.dynamicImportVarsOptions

Тип: RollupDynamicImportVarsOptions
Связанный: Dynamic Import

Параметры для перехода к @rollup/plugin-dynamic-import-vars.

build.lib

Тип: { entry: string | string[] | { [entryAlias: string]: string }, name?: string, formats?: ('es' | 'cjs' | 'umd' | 'iife')[], fileName?: string | ((format: ModuleFormat, entryName: string) => string) }
Связанный: Library Mode

Построить как библиотеку. entry необходима, так как библиотека не может использовать HTML в качестве записи. name является открытой глобальной переменной и требуется, когда formats включает 'umd' или 'iife'. Форматы formats по умолчанию: ['es', 'umd'] , или ['es', 'cjs'], если используется несколько записей. fileName — это имя выходного файла пакета, по умолчанию fileName — это параметр имени package.json, его также можно определить как функцию, принимающую format в качестве аргумента и entryAlias в качестве аргументов.

build.manifest

Тип: boolean | string | string[] | { [entryAlias: string]: string }
По умолчанию: false
Связанный: Backend Integration

Если установлено значение true, сборка также создаст файл manifest.json, который содержит сопоставление нехэшированных имен файлов ресурсов с их хэшированными версиями, которые затем могут использоваться серверной структурой для отображения правильных ссылок на ресурсы. Если значение представляет собой строку, оно будет использоваться в качестве имени файла манифеста.

build.ssrManifest

Тип: boolean | string
По умолчанию: false
Связанный: Server-Side Rendering

Если установлено значение true, сборка также будет генерировать манифест SSR для определения ссылок на стили и директив предварительной загрузки ресурсов в рабочей среде. Если значение представляет собой строку, оно будет использоваться в качестве имени файла манифеста.

build.ssr

Тип: boolean | string
По умолчанию: undefined
Связанный: Server-Side Rendering

Создание сборки, ориентированной на SSR. Значение может быть строкой для прямого указания записи SSR или true, что требует указания записи SSR через rollupOptions.input.

build.minify

Тип: boolean | 'terser' | 'esbuild'
По умолчанию: 'esbuild'

Установите значение false, чтобы отключить минимизацию, или укажите минимизатор для использования. По умолчанию используется esbuild, который в 20–40 раз быстрее, чем краткий, и только на 1–2% хуже сжатие. Тесты

Note the build.minify option does not minify whitespaces when using the 'es' format in lib mode, as it removes pure annotations and breaks tree-shaking.

Обратите внимание, что опция build.minify не минимизирует пробелы при использовании формата 'es' в режиме lib, поскольку она удаляет чистые аннотации и прерывает встряхивание дерева.

Terser должен быть установлен, если для него задано значение 'terser'.

npm add -D terser

build.terserOptions

Тип: TerserOptions

Дополнительные опции минимизации для передачи в Terser.

build.write

Тип: boolean
По умолчанию: true

Установите значение false, чтобы отключить запись пакета на диск. В основном это используется в программных вызовах build(), где перед записью на диск требуется дополнительная постобработка пакета.

build.emptyOutDir

Тип: boolean
По умолчанию: true, если outDir находится внутри root

По умолчанию Vite очищает outDir при сборке, если он находится внутри корня проекта. Он выдаст предупреждение, если outDir находится за пределами root, чтобы избежать случайного удаления важных файлов. Вы можете явно установить этот параметр, чтобы скрыть предупреждение. Это также доступно через командную строку как --emptyOutDir.

build.copyPublicDir

Experimental
Тип: boolean
По умолчанию: true

По умолчанию Vite копирует файлы из publicDir в outDir при сборке. Установите false, чтобы отключить это.

build.reportCompressedSize

Тип: boolean
По умолчанию: true

Включить/отключить отчеты о размерах, сжатых gzip. Сжатие больших выходных файлов может быть медленным, поэтому его отключение может повысить производительность сборки для больших проектов.

build.chunkSizeWarningLimit

Тип: number
По умолчанию: 500

Ограничение предупреждений о размере фрагмента (в КБ).

build.watch

Тип: WatcherOptions| null
По умолчанию: null

Установите {}, чтобы включить наблюдатель сводки. Это в основном используется в случаях, когда речь идет о плагинах только для сборки или процессах интеграции.

Использование Vite в подсистеме Windows для Linux (WSL) 2

Бывают случаи, когда просмотр файловой системы не работает с WSL2. Подробнее смотрите server.watch.

Параметры сборки #

build.target #

build.modulePreload #

build.polyfillModulePreload #

build.outDir #

build.assetsDir #

build.assetsInlineLimit #

build.cssCodeSplit #

build.cssTarget #

build.sourcemap #

build.rollupOptions #

build.commonjsOptions #

build.dynamicImportVarsOptions #

build.lib #

build.manifest #

build.ssrManifest #

build.ssr #

build.minify #

build.terserOptions #

build.write #

build.emptyOutDir #

build.copyPublicDir #

build.reportCompressedSize #

build.chunkSizeWarningLimit #

build.watch #