diff --git a/config/index.md b/config/index.md index 5ca9b168..3c45ad7c 100644 --- a/config/index.md +++ b/config/index.md @@ -483,6 +483,23 @@ export default defineConfig(async ({ command, mode }) => { 当需要再 Windows Subsystem for Linux (WSL) 2 上运行 Vite 时,如果项目文件夹位于 Windows 文件系统中,你需要将此选项设置为 `{ usePolling: true }`。这是由于 Windows 文件系统的 [WSL2 限制](https://github.com/microsoft/WSL/issues/4739) 造成的。 + Vite 服务器默认会忽略对 `.git/` 和 `node_modules/` 目录的监听。如果你需要对 `node_moduels/` 内的包进行监听,你可以为 `server.watch.ignored` 赋值一个取反的 glob 模式,例如: + + ```js + export default defineConfig({ + server: { + watch: { + ignored: ['!**/node_modules/your-package-name/**'] + } + }, + // 被监听的包必须被排除在优化之外, + // 以便它能出现在依赖关系图中并触发热更新。 + optimizeDeps: { + exclude: ['your-package-name'] + } + }) + ``` + ### server.middlewareMode {#server-middlewaremode} - **类型:** `'ssr' | 'html'` @@ -655,6 +672,17 @@ export default defineConfig({ 如果禁用,整个项目中的所有 CSS 将被提取到一个 CSS 文件中。 +### build.cssTarget {#build-csstarget} + +- **类型:** `string | string[]` +- **默认值:** 与 [`build.target`](/config/#build-target) 一致 + + 此选项允许用户为 CSS 的压缩设置一个不同的浏览器 target,此处的 target 并非是用于 JavaScript 转写目标。 + + 应只在针对非主流浏览器时使用。 + 最直观的示例是当你要兼容的场景是安卓微信中的 webview 时,它支持大多数现代的 JavaScript 功能,但并不支持 [CSS 中的 `#RGBA` 十六进制颜色符号](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value#rgb_colors)。 + 这种情况下,你需要将 `build.cssTarget` 设置为 `chrome61`,以防止 vite 将 `rgba()` 颜色转化为 `#RGBA` 十六进制符号的形式。 + ### build.sourcemap {#build-sourcemap} - **类型:** `boolean | 'inline'` | 'hidden'` diff --git a/guide/api-plugin.md b/guide/api-plugin.md index e3401951..baa55420 100644 --- a/guide/api-plugin.md +++ b/guide/api-plugin.md @@ -290,7 +290,7 @@ Vite 插件也可以提供钩子来服务于特定的 Vite 目标。这些钩子 ### `transformIndexHtml` {#transformindexhtml} -- **类型:** `IndexHtmlTransformHook | { enforce?: 'pre' | 'post' transform: IndexHtmlTransformHook }` +- **类型:** `IndexHtmlTransformHook | { enforce?: 'pre' | 'post', transform: IndexHtmlTransformHook }` - **种类:** `async`, `sequential` 转换 `index.html` 的专用钩子。钩子接收当前的 HTML 字符串和转换上下文。上下文在开发期间暴露[`ViteDevServer`](./api-javascript#ViteDevServer)实例,在构建期间暴露 Rollup 输出的包。