docs(cn): resolve conflicts

Author: waynzh

config/index.md

@@ -67,11 +67,7 @@ export default defineConfig(({ command, mode, isSsrBuild, isPreview }) => {
 })
 ```
 
-<<<<<<< HEAD
-需要注意的是，在 Vite 的 API 中，在开发环境下 `command` 的值为 `serve`（在 CLI 中， `vite dev` 和 `vite serve` 是 `vite` 的别名），而在生产环境下为 `build`（`vite build`）。
-=======
-It is important to note that in Vite's API the `command` value is `serve` during dev (in the cli [`vite`](/guide/cli#vite), `vite dev`, and `vite serve` are aliases), and `build` when building for production ([`vite build`](/guide/cli#vite-build)).
->>>>>>> 7d52e9105212d56475f86d759d0d77c071cbbdcf
+需要注意的是，在 Vite 的 API 中，在开发环境下 `command` 的值为 `serve`（在 CLI 中， `vite dev` 和 `vite serve` 是 [`vite`](/guide/cli#vite) 的别名），而在生产环境下为 `build`（[`vite build`](/guide/cli#vite-build)）。
 
 `isSsrBuild` 和 `isPreview` 是额外的可选标志，用于区分 `build` 和 `serve` 命令的类型。一些加载 Vite 配置的工具可能不支持这些标志，而会传递 `undefined`。因此，建议使用 `true` 和 `false` 的显式比较。
 

config/server-options.md

@@ -152,13 +152,9 @@ export default defineConfig({
 
 设置 `server.hmr.overlay` 为 `false` 可以禁用开发服务器错误的屏蔽。
 
-<<<<<<< HEAD
-`clientPort` 是一个高级选项，只在客户端的情况下覆盖端口，这允许你为 websocket 提供不同的端口，而并非在客户端代码中查找。如果需要在 dev-server 情况下使用 SSL 代理，这非常有用。
-=======
-`protocol` sets the WebSocket protocol used for the HMR connection: `ws` (WebSocket) or `wss` (WebSocket Secure).
+`protocol` 是用于设置 HMR 连接使用的 WebSocket 协议的选项，可以是 `ws`（WebSocket）或者 `wss`（WebSocket Secure）。
 
-`clientPort` is an advanced option that overrides the port only on the client side, allowing you to serve the websocket on a different port than the client code looks for it on.
->>>>>>> 7d52e9105212d56475f86d759d0d77c071cbbdcf
+`clientPort` 是一个高级选项，只在客户端的情况下覆盖端口，这允许你为 websocket 提供不同的端口，而并非在客户端代码中查找。如果需要在 dev-server 情况下使用 SSL 代理，这非常有用。
 
 当 `server.hmr.server` 被定义后，Vite 将会通过所提供的的服务器来处理 HMR 连接。如果不是在中间件模式下，Vite 将尝试通过已有服务器处理 HMR 连接。这在使用自签证书或想通过网络在某端口暴露 Vite 的情况下，非常有用。
 

config/shared-options.md

@@ -163,18 +163,14 @@ Vite 有一个“允许的情景”列表，并且会匹配列表中第一个情
 - **相关：** [esbuild#preserve-symlinks](https://esbuild.github.io/api/#preserve-symlinks)，[webpack#resolve.symlinks
   ](https://webpack.js.org/configuration/resolve/#resolvesymlinks)
 
-<<<<<<< HEAD
-## css.modules {#css-modules}
-=======
 ## html.cspNonce
 
-- **Type:** `string`
-- **Related:** [Content Security Policy (CSP)](/guide/features#content-security-policy-csp)
+- **类型：** `string`
+- **相关：** [内容安全策略（CSP）](/guide/features#content-security-policy-csp)
 
-A nonce value placeholder that will be used when generating script / style tags. Setting this value will also generate a meta tag with nonce value.
+一个在生成脚本或样式标签时会用到的 nonce 值占位符。设置此值还会生成一个带有 nonce 值的 meta 标签。
 
 ## css.modules
->>>>>>> 7d52e9105212d56475f86d759d0d77c071cbbdcf
 
 - **类型：**
   ```ts

config/ssr-options.md

@@ -18,11 +18,7 @@
 
 这个选项可以防止列出的依赖项在服务端渲染（SSR）时被外部化，这些依赖项将会在构建过程中被打包。默认情况下，只有软链接的依赖项不会被外部化（这是为了HMR）。如果你希望将软链接的依赖项也外部化，可以将其名称传给 `ssr.external` 选项。
 
-<<<<<<< HEAD
-如果这个选项设置为 `true`，那么没有任何依赖项会被外部化。然而，如果你在 `ssr.external` 中明确列出了一些依赖项（使用 `string[]` 类型），那么这些依赖项可以优先被外部化。
-=======
-If `true`, no dependencies are externalized. However, dependencies explicitly listed in `ssr.external` (using `string[]` type) can take priority and still be externalized. If `ssr.target: 'node'` is set, Node.js built-ins will also be externalized by default.
->>>>>>> 7d52e9105212d56475f86d759d0d77c071cbbdcf
+如果这个选项设置为 `true`，那么没有任何依赖项会被外部化。然而，如果你在 `ssr.external` 中明确列出了一些依赖项（使用 `string[]` 类型），那么这些依赖项可以优先被外部化。如果设置了 `ssr.target: 'node'`，那么 Node.js 的内置模块也会被默认外部化。
 
 需要注意的是，如果 `ssr.noExternal: true` 和 `ssr.external: true` 都被设置了，那么 `ssr.noExternal` 将优先生效，没有任何依赖项会被外部化。
 

guide/api-hmr.md

@@ -210,11 +210,7 @@ import.meta.hot.accept((module) => {
 
 ## `hot.off(event, cb)` {#hot-offevent-cb}
 
-<<<<<<< HEAD
 从事件监听器中移除回调函数。
-=======
-Remove callback from the event listeners.
->>>>>>> 7d52e9105212d56475f86d759d0d77c071cbbdcf
 
 ## `hot.send(event, data)` {#hot-send-event-data}
 

guide/api-javascript.md

@@ -18,28 +18,15 @@ import { createServer } from 'vite'
 
 const __dirname = fileURLToPath(new URL('.', import.meta.url))
 
-<<<<<<< HEAD
-;(async () => {
-  const server = await createServer({
-    // 任何合法的用户配置选项，加上 `mode` 和 `configFile`
-    configFile: false,
-    root: __dirname,
-    server: {
-      port: 1337,
-    },
-  })
-  await server.listen()
-=======
 const server = await createServer({
-  // any valid user config options, plus `mode` and `configFile`
+  // 任何合法的用户配置选项，加上 `mode` 和 `configFile`
   configFile: false,
   root: __dirname,
   server: {
     port: 1337,
   },
 })
 await server.listen()
->>>>>>> 7d52e9105212d56475f86d759d0d77c071cbbdcf
 
 server.printUrls()
 server.bindCLIShortcuts({ print: true })
@@ -190,29 +177,25 @@ interface ViteDevServer {
    */
   close(): Promise<void>
   /**
-   * Bind CLI shortcuts
+   * 绑定 CLI 快捷键
    */
   bindCLIShortcuts(options?: BindCLIShortcutsOptions<ViteDevServer>): void
   /**
-   * Calling `await server.waitForRequestsIdle(id)` will wait until all static imports
-   * are processed. If called from a load or transform plugin hook, the id needs to be
-   * passed as a parameter to avoid deadlocks. Calling this function after the first
-   * static imports section of the module graph has been processed will resolve immediately.
-   * @experimental
+   * 调用 `await server.waitForRequestsIdle(id)` 会等待所有的静态导入
+   * 都被处理完。如果这个函数是从一个加载或转换的插件钩子中被调用的，那么你需要
+   * 把 id 作为参数传入，以避免死锁。在模块图的第一个静态导入部分被处理之后
+   * 调用这个函数，它将立即返回。
+   * @实验性
    */
   waitForRequestsIdle: (ignoredId?: string) => Promise<void>
 }
 ```
 
-<<<<<<< HEAD
-## `build` {#build}
-=======
 :::info
-`waitForRequestsIdle` is meant to be used as a escape hatch to improve DX for features that can't be implemented following the on-demand nature of the Vite dev server. It can be used during startup by tools like Tailwind to delay generating the app CSS classes until the app code has been seen, avoiding flashes of style changes. When this function is used in a load or transform hook, and the default HTTP1 server is used, one of the six http channels will be blocked until the server processes all static imports. Vite's dependency optimizer currently uses this function to avoid full-page reloads on missing dependencies by delaying loading of pre-bundled dependencies until all imported dependencies have been collected from static imported sources. Vite may switch to a different strategy in a future major release, setting `optimizeDeps.crawlUntilStaticImports: false` by default to avoid the performance hit in large applications during cold start.
+`waitForRequestsIdle` 的设计初衷是作为一种应急措施，以改善那些无法按照 Vite 开发服务器按需加载特性来实现的功能的开发体验。像 Tailwind 这样的工具可以在启动期间使用它，以便在应用代码被加载之前延迟生成应用的 CSS 类，从而避免样式的闪烁变化。当这个函数在加载或转换钩子中被使用，并且使用的是默认的 HTTP1 服务器时，六个 http 通道中的一个将被阻塞，直到服务器处理完所有的静态导入。Vite 的依赖优化器目前使用这个函数来避免在缺少依赖项时进行全页刷新，它通过延迟加载预打包的依赖项，直到从静态导入的源收集到所有的导入依赖项。在未来的主要版本中，Vite 可能会采取不同的策略，将 `optimizeDeps.crawlUntilStaticImports: false` 设置为默认值，以避免在大型应用程序在冷启动期间出现性能下降。
 :::
 
-## `build`
->>>>>>> 7d52e9105212d56475f86d759d0d77c071cbbdcf
+## `build` {#build}
 
 **类型校验：**
 
@@ -254,20 +237,9 @@ async function preview(inlineConfig?: InlineConfig): Promise<PreviewServer>
 
 ```ts twoslash
 import { preview } from 'vite'
-<<<<<<< HEAD
-;(async () => {
-  const previewServer = await preview({
-    // 任何有效的用户配置项，将加上 `mode` 和 `configFile`
-    preview: {
-      port: 8080,
-      open: true,
-    },
-  })
-=======
->>>>>>> 7d52e9105212d56475f86d759d0d77c071cbbdcf
 
 const previewServer = await preview({
-  // any valid user config options, plus `mode` and `configFile`
+  // 任何合法的用户配置选项，加上 `mode` 和 `configFile`
   preview: {
     port: 8080,
     open: true,

guide/assets.md

@@ -32,11 +32,8 @@ document.getElementById('hero-img').src = imgUrl
 
 - 默认情况下，TypeScript 不会将静态资源导入视为有效的模块。要解决这个问题，需要添加 [`vite/client`](./features#client-types)。
 
-<<<<<<< HEAD
-### 显式 URL 引入 {#explicit-url-imports}
-=======
-::: tip Inlining SVGs through `url()`
-When passing a URL of SVG to a manually constructed `url()` by JS, the variable should be wrapped within double quotes.
+::: tip 通过 `url()` 内联 SVG
+当在 JS 中手动构造 `url()` 并传入一个 SVG 的 URL 时，应该用双引号将变量包裹起来。
 
 ```js twoslash
 import 'vite/client'
@@ -47,8 +44,7 @@ document.getElementById('hero-img').style.background = `url("${imgUrl}")`
 
 :::
 
-### Explicit URL Imports
->>>>>>> 7d52e9105212d56475f86d759d0d77c071cbbdcf
+### 显式 URL 引入 {#explicit-url-imports}
 
 未被包含在内部列表或 `assetsInclude` 中的资源，可以使用 `?url` 后缀显式导入为一个 URL。这十分有用，例如，要导入 [Houdini Paint Worklets](https://houdini.how/usage) 时：
 
@@ -73,15 +69,10 @@ import shaderString from './shader.glsl?raw'
 
 脚本可以通过 `?worker` 或 `?sharedworker` 后缀导入为 web worker。
 
-<<<<<<< HEAD
-```js
-// 在生产构建中将会分离出 chunk
-=======
 ```js twoslash
 import 'vite/client'
 // ---cut---
-// Separate chunk in the production build
->>>>>>> 7d52e9105212d56475f86d759d0d77c071cbbdcf
+// 在生产构建中将会分离出 chunk
 import Worker from './shader.js?worker'
 const worker = new Worker()
 ```
@@ -94,15 +85,10 @@ import SharedWorker from './shader.js?sharedworker'
 const sharedWorker = new SharedWorker()
 ```
 
-<<<<<<< HEAD
-```js
-// 内联为 base64 字符串
-=======
 ```js twoslash
 import 'vite/client'
 // ---cut---
-// Inlined as base64 strings
->>>>>>> 7d52e9105212d56475f86d759d0d77c071cbbdcf
+// 内联为 base64 字符串
 import InlineWorker from './shader.js?worker&inline'
 ```
 

guide/backend-integration.md

@@ -87,65 +87,56 @@
    - 清单是一个 `Record<name, chunk>` 结构的对象。
    - 对于 入口 或动态入口 chunk，键是相对于项目根目录的资源路径。
    - 对于非入口 chunk，键是生成文件的名称并加上前缀 `_`。
-   - Chunk 将信息包含在其静态和动态导入上（两者都是映射到清单中相应 chunk 的键)，以及任何与之相关的 CSS 和资源文件。
+   - Chunk 将信息包含在其静态和动态导入上（两者都是映射到清单中相应 chunk 的键），以及任何与之相关的 CSS 和资源文件。
 
-<<<<<<< HEAD
-   你可以使用这个文件来渲染链接或者用散列文件名预加载指令（注意：这里的语法只是为了解释，实际使用时请你的服务器模板语言代替）：
+4. 你可以利用这个文件来渲染带有哈希文件名的链接或预加载指令。
 
-   ```html
-   <!-- 如果是在生产环境中 -->
-   <link rel="stylesheet" href="/assets/{{ manifest['main.js'].css }}" />
-   <script type="module" src="/assets/{{ manifest['main.js'].file }}"></script>
-=======
-4. You can use this file to render links or preload directives with hashed filenames.
-
-   Here is an example HTML template to render the proper links. The syntax here is for
-   explanation only, substitute with your server templating language. The `importedChunks`
-   function is for illustration and isn't provided by Vite.
+   这是一个用来渲染正确链接的 HTML 模板示例。这里的语法仅用于解释，
+   你需要用你的服务器模板语言来替换。`importedChunks` 函数只是
+   用来说明，并不是 Vite 提供的。
 
    ```html
-   <!-- if production -->
+   <!-- 如果是生产环境 -->
 
-   <!-- for cssFile of manifest[name].css -->
+   <!-- 对于 manifest[name].css 中的 cssFile -->
    <link rel="stylesheet" href="/{{ cssFile }}" />
 
-   <!-- for chunk of importedChunks(manifest, name) -->
-   <!-- for cssFile of chunk.css -->
+   <!-- 对于 importedChunks(manifest, name) 中的 chunk  -->
+   <!-- 对于 chunk.css 中的 cssFile -->
    <link rel="stylesheet" href="/{{ cssFile }}" />
 
    <script type="module" src="/{{ manifest[name].file }}"></script>
 
-   <!-- for chunk of importedChunks(manifest, name) -->
+   <!-- 对于 importedChunks(manifest, name) 中的 chunk  -->
    <link rel="modulepreload" src="/{{ chunk.file }}" />
    ```
 
-   Specifically, a backend generating HTML should include the following tags given a manifest
-   file and an entry point:
+   具体来说，一个生成 HTML 的后端在给定 manifest 文件和一个入口文件的情况下，
+   应该包含以下标签：
 
-   - A `<link rel="stylesheet">` tag for each file in the entry point chunk's `css` list
-   - Recursively follow all chunks in the entry point's `imports` list and include a
-     `<link rel="stylesheet">` tag for each css file of each imported chunk.
-   - A tag for the `file` key of the entry point chunk (`<script type="moudle">` for Javascript,
-     or `<link rel="stylesheet">` for css)
-   - Optionally, `<link rel="modulepreload">` tag for the `file` of each imported Javascript
-     chunk, again recursively following the imports starting from the entry point chunk.
+   - 对于入口文件 chunk 的 `css` 列表中的每个文件，都应包含一个 `<link rel="stylesheet">` 标签。
+   - 递归追踪入口文件的 `imports` 列表中的所有 chunk，并为每个导入的 chunk 的每个 css 文件
+     包含一个 `<link rel="stylesheet">` 标签。
+   - 对于入口文件 chunk 的 `file` 键的标签（对于 Javascript 是 
+     `<script type="moudle">`，对于 css 是 `<link rel="stylesheet">`）
+   - 可选项，对于每个导入的 Javascript chunk 的 `file` 键的 `<link rel="modulepreload">` 标签，
+     同样从入口文件 chunk 开始递归追踪导入。
 
-   Following the above example manifest, for the entry point `main.js` the following tags should be included in production:
+   按照上面的示例 manifest，对于入口文件 `main.js`，在生产环境中应包含以下标签：
 
    ```html
    <link rel="stylesheet" href="assets/main.b82dbe22.css" />
    <link rel="stylesheet" href="assets/shared.a834bfc3.css" />
    <script type="module" src="assets/main.4889e940.js"></script>
-   <!-- optional -->
+   <!-- 可选 -->
    <link rel="modulepreload" src="assets/shared.83069a53.js" />
    ```
 
-   While the following should be included for the entry point `views/foo.js`:
+   而对于入口文件 `views/foo.js`，应该包含以下标签：
 
    ```html
    <link rel="stylesheet" href="assets/shared.a834bfc3.css" />
    <script type="module" src="assets/foo.869aea0d.js"></script>
-   <!-- optional -->
+   <!-- 可选 -->
    <link rel="modulepreload" src="assets/shared.83069a53.js" />
->>>>>>> 7d52e9105212d56475f86d759d0d77c071cbbdcf
    ```

guide/build.md

@@ -69,11 +69,7 @@ export default defineConfig({
 
 ```js twoslash
 window.addEventListener('vite:preloadError', (event) => {
-<<<<<<< HEAD
-  window.reload() // 例如，刷新页面
-=======
-  window.location.reload() // for example, refresh the page
->>>>>>> 7d52e9105212d56475f86d759d0d77c071cbbdcf
+  window.location.reload() // 例如，刷新页面
 })
 ```
 
@@ -295,4 +291,4 @@ const config: UserConfig = {
 }
 ```
 
-Note that the `filename` passed is a decoded URL, and if the function returns a URL string, it should also be decoded. Vite will handle the encoding automatically when rendering the URLs. If an object with `runtime` is returned, encoding should be handled yourself where needed as the runtime code will be rendered as is.
+请注意，传递的 `filename` 是一个已解码的 URL，如果函数返回了一个 URL 字符串，那么它也应该是已解码的。当 Vite 渲染 URL 时会自动处理编码。如果返回的是一个带有 `runtime` 的对象，就需要在必要的地方自行处理编码，因为运行时的代码将会按照原样呈现。

guide/cli.md

@@ -4,11 +4,7 @@
 
 ### `vite` {#vite}
 
-<<<<<<< HEAD
-在当前目录下启动 Vite 开发服务器。
-=======
-Start Vite dev server in the current directory. `vite dev` and `vite serve` are aliases for `vite`.
->>>>>>> 7d52e9105212d56475f86d759d0d77c071cbbdcf
+在当前目录下启动 Vite 开发服务器。`vite dev` 和 `vite serve` 是 `vite` 的别名。
 
 #### 使用 {#usage}