release: v2.7.0

Author: QC-L

config/index.md

@@ -235,9 +235,14 @@ export default defineConfig(async ({ command, mode }) => {
       | ((name: string, filename: string, css: string) => string)
     hashPrefix?: string
     /**
-     * 默认：'camelCaseOnly'
+     * default: null
      */
-    localsConvention?: 'camelCase' | 'camelCaseOnly' | 'dashes' | 'dashesOnly'
+    localsConvention?:
+      | 'camelCase'
+      | 'camelCaseOnly'
+      | 'dashes'
+      | 'dashesOnly'
+      | null
   }
   ```
 
@@ -785,12 +790,12 @@ export default defineConfig({
 
   默认情况下，若 `outDir` 在 `root` 目录下，则 Vite 会在构建时清空该目录。若 `outDir` 在根目录之外则会抛出一个警告避免意外删除掉重要的文件。可以设置该选项来关闭这个警告。该功能也可以通过命令行参数 `--emptyOutDir` 来使用。
 
-### build.brotliSize {#build-brotlisize}
+### build.reportCompressedSize {#build-reportcompressedsize}
 
 - **类型：** `boolean`
 - **默认：** `true`
 
-  启用/禁用 brotli 压缩大小报告。压缩大型输出文件可能会很慢，因此禁用该功能可能会提高大型项目的构建性能。
+  启用/禁用 gzip 压缩大小报告。压缩大型输出文件可能会很慢，因此禁用该功能可能会提高大型项目的构建性能。
 
 ### build.chunkSizeWarningLimit {#build-chunksizewarninglimit}
 
@@ -914,14 +919,17 @@ export default defineConfig({
 
   默认情况下，不在 `node_modules` 中的，链接的包不会被预构建。使用此选项可强制预构建链接的包。
 
-### optimizeDeps.keepNames {#optimizedeps-keepnames}
+### optimizeDeps.esbuildOptions {#optimizedeps-esbuildoptions}
 
-- **类型：** `boolean`
-- **默认：** `false`
+- **类型：** [`EsbuildBuildOptions`](https://esbuild.github.io/api/#simple-options)
+
+  在部署扫描和优化过程中传递给 esbuild 的选项。
+
+  某些选项进行了省略，因为修改它们与 Vite 的优化方案并不兼容。
 
-  打包器有时需要重命名符号以避免冲突。
-  设置此项为 `true` 可以在函数和类上保留 `name` 属性。
-  若想获取更多详情，请参阅 [`keepNames`](https://esbuild.github.io/api/#keep-names)
+  - 忽略了 `external` 选项，请使用 Vite 的 `optimizeDeps.exclude` 选项
+  - `plugins` 与 Vite 的 dep 插件合并
+  - `keepNames` 优级高于被废弃的 `optimizeDeps.keepNames`
 
 ## SSR 选项 {#ssr-options}
 

guide/api-plugin.md

@@ -36,7 +36,6 @@ Vite 努力秉承开箱即用的原则，因此在创作一款新插件前，请
 - `vite-plugin-react-` 前缀作为 React 插件
 - `vite-plugin-svelte-` 前缀作为 Svelte 插件
 
-
 Vite 对虚拟模块的规范是在路径前加上 `virtual:`。如果可能的话，插件名应该作为命名空间使用，以避免与生态系统中的其他插件发生冲突。例如，`vite-plugin-posts` 可以让用户引入 `virtual:posts` 或 `virtual:posts/helpers` 虚拟模块，以获得构建时信息。在内部，使用虚拟模块的插件在解析模块 ID 时应以 `\0` 为前缀，这是一个来自 Rollup 生态系统的惯例。这可以防止其他插件试图处理这个 ID（如节点解析），而像 sourcemap 这样的核心功能可以使用这些信息来区分虚拟模块和普通文件。`\0` 在导入的 URL 中不是一个允许的字符，所以我们必须在导入分析中替换它们。在浏览器中，一个 `0{id}` 的虚拟 ID 最终被编码为 `/@id/__x00__{id}`。在进入插件处理管道之前，这个 ID 会被解码回来。所以这个过程在插件钩子代码中将是不可见的。
 
 请注意，模块都直接来源于真实的文件，而单文件组件（比如 .vue 或 .svelte 文件）中的 script 模块将不需要这样的转换。单文件组件被处理时一般会生成一系列子模块但其代码都可以被映射回文件系统。对这些子模块使用 `\0` 会使得 sourcemap 工作异常。

guide/backend-integration.md

@@ -39,7 +39,7 @@
 
    还要确保服务器配置为提供 Vite 工作目录中的静态资源，否则图片等资源将无法正确加载。
 
-   如果你正使用 `@vitejs/plugin-react-refresh` 配合 React，你还需要在上述脚本前添加下面这个，因为插件不能修改你正在服务的 HTML：
+   如果你正使用 `@vitejs/plugin-react` 配合 React，你还需要在上述脚本前添加下面这个，因为插件不能修改你正在服务的 HTML：
 
    ```html
    <script type="module">

guide/index.md

@@ -115,7 +115,8 @@ Vite 也支持多个 `.html` 作入口点的 [多页面应用模式](./build#mul
 
 在安装了 Vite 的项目中，可以在 npm scripts 中使用 `vite` 可执行文件，或者直接使用 `npx vite` 运行它。下面是通过脚手架创建的 Vite 项目中默认的 npm scripts：
 
-```jsonc
+<!-- prettier-ignore -->
+```json5
 {
   "scripts": {
     "dev": "vite", // 启动开发服务器，别名：`vite dev`，`vite serve`

guide/migration.md

@@ -90,7 +90,7 @@ export default defineConfig({
 
 ## React 支持 {#react-support}
 
-现已支持 React Fast Refresh，详见 [`@vitejs/plugin-react-refresh`](https://github.com/vitejs/vite/tree/main/packages/plugin-react-refresh)。
+现已支持 React Fast Refresh，详见 [`@vitejs/plugin-react`](https://github.com/vitejs/vite/tree/main/packages/plugin-react)。
 
 ## HMR API 变化 {#hmr-api-change}
 

guide/ssr.md

@@ -31,6 +31,7 @@ Vite 为服务端渲染（SSR）提供了内建支持。这里的 Vite 范例包
 
 ```
 - index.html
+- server.js # main application server
 - src/
   - main.js          # 导出环境无关的（通用的）应用代码
   - entry-client.js  # 将应用挂载到一个 DOM 元素上
@@ -76,8 +77,13 @@ async function createServer() {
   // 以中间件模式创建 Vite 应用，这将禁用 Vite 自身的 HTML 服务逻辑
   // 并让上级服务器接管控制
   //
+<<<<<<< HEAD
   // 如果你想使用 Vite 自己的 HTML 服务逻辑（将 Vite 作为
   // 一个开发中间件来使用），那么这里请用 'html'
+=======
+  // In middleware mode, if you want to use Vite's own HTML serving logic
+  // use `'html'` as the `middlewareMode` (ref https://vitejs.dev/config/#server-middlewaremode)
+>>>>>>> 7ee013df1d23732b3f0f880c414c161ad21657f5
   const vite = await createViteServer({
     server: { middlewareMode: 'ssr' }
   })
@@ -111,7 +117,7 @@ app.use('*', async (req, res) => {
 
     // 2. 应用 Vite HTML 转换。这将会注入 Vite HMR 客户端，
     //    同时也会从 Vite 插件应用 HTML 转换。
-    //    例如：@vitejs/plugin-react-refresh 中的 global preambles
+    //    例如：@vitejs/plugin-react 中的 global preambles
     template = await vite.transformIndexHtml(url, template)
 
     // 3. 加载服务器入口。vite.ssrLoadModule 将自动转换
@@ -250,8 +256,8 @@ export function mySSRPlugin() {
 
 `options` 中的 `load` 和 `transform` 为可选项，rollup 目前并未使用该对象，但将来可能会用额外的元数据来扩展这些钩子函数。
 
-::: 注意
-Vite 2.7 之前的版本，会提示你 `ssr` 参数的位置不应该是 `options` 对象。目前所有主框架和插件都已对应更新，但你可能还会发现使用过时 API 的旧文章。
+:::tip Note
+Vite 2.7 之前的版本，会提示你 `ssr` 参数的位置不应该是 `options` 对象。目前所有主要框架和插件都已对应更新，但你可能还是会发现使用过时 API 的旧文章。
 :::
 
 ## SSR Target {#ssr-target}

guide/static-deploy.md

@@ -87,7 +87,7 @@ $ npm run preview
    # git push -f [email protected]:<USERNAME>/<USERNAME>.github.io.git main
 
    # 如果你要部署在 https://<USERNAME>.github.io/<REPO>
-   # git push -f [email protected]:<USERNAME>/<REPO>.git master:gh-pages
+   # git push -f [email protected]:<USERNAME>/<REPO>.git main:gh-pages
 
    cd -
    ```
@@ -127,7 +127,7 @@ $ npm run preview
      github_token: $GITHUB_TOKEN
      keep_history: true
      on:
-       branch: master
+       branch: main
    ```
 
 ## GitLab Pages 配合 GitLab CI {#gitlab-pages-and-gitlab-ci}
@@ -159,7 +159,7 @@ $ npm run preview
        paths:
          - public
      rules:
-       - $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+       - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
    ```
 
 ## Netlify {#netlify}
@@ -259,7 +259,7 @@ $ npm run preview
 
    ```bash
    # 发布站点
-   $ git push heroku master
+   $ git push heroku main
 
    # 在浏览器中打开 Heroku 的面板
    $ heroku open