docs(cn): release merge into dev @6a59445f (#874)

NoiseFan · web3Worker-x · web3Worker-x · web-flow · commit 110975576e6e · 2025-12-16T10:48:48.000+08:00
* docs(coverage): update guide/coverage.md (#845) * docs(timer): update /mocking/timer comment 修改 [/mocking/timer](https://cn.vitest.dev/guide/mocking/timers.html#example) 未翻译的注释 * docs(coverage): update guide/coverage.md --------- Co-authored-by: NoiseFan <noisefan@163.com> Co-authored-by: web3Worker-x <a@b.com> * Modify the v3 guide link in mocking-classes * docs: translate /guide/mocking/classes (#849) * docs(timer): update /mocking/timer comment 修改 [/mocking/timer](https://cn.vitest.dev/guide/mocking/timers.html#example) 未翻译的注释 * docs(classes): Add translate --------- Co-authored-by: NoiseFan <noisefan@163.com> * Modify the v3 guide link in mocking-classes * docs(reporters): fix link formatting issues in the document (#848) * docs(timer): update /mocking/timer comment 修改 [/mocking/timer](https://cn.vitest.dev/guide/mocking/timers.html#example) 未翻译的注释 * docs(reporters): fix link formatting issues in the document * docs(reporters): fix link formatting issues in the document --------- Co-authored-by: NoiseFan <noisefan@163.com> * docs(cn): update menu item translate (#846) * docs(timer): update /mocking/timer comment 修改 [/mocking/timer](https://cn.vitest.dev/guide/mocking/timers.html#example) 未翻译的注释 * docs(cn): update menu item translate --------- Co-authored-by: NoiseFan <noisefan@163.com> * docs(cn): update testTimeout default value and description (#851) * docs(timer): update /mocking/timer comment 修改 [/mocking/timer](https://cn.vitest.dev/guide/mocking/timers.html#example) 未翻译的注释 * docs: update testTimeout default value and description * Update config/testtimeout.md Co-authored-by: NoiseFan <noisefan@163.com> --------- Co-authored-by: NoiseFan <noisefan@163.com> * docs(runner): update /config/runner.md (#853) * docs(benchmark): update config/benchmark description (#856) * docs(benchmark): update config/benchmark description * Update config/benchmark.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update config/benchmark.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update config/benchmark.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Kylin <75473409+lxKylin@users.noreply.github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * docs(guide/advanced/reporters): update comment for MyDefaultReporter (#859) * docs(fileparallelism): translate config/fileparallelism * docs(fileparallelism): translate config/fileparallelism * Update config/fileparallelism.md * docs(watch): update /config/watch comment (#852) * docs(watch): update /config/watch comment * Update config/watch.md Co-authored-by: NoiseFan <noisefan@163.com> * Update config/watch.md Co-authored-by: NoiseFan <noisefan@163.com> --------- Co-authored-by: thinkasany <480968828@qq.com> Co-authored-by: NoiseFan <noisefan@163.com> * docs(testnamepattern): translate config/testnamepattern (#855) * docs(testnamepattern): translate config/testnamepattern * docs(testnamepattern): translate config/testnamepattern * docs(testnamepattern): translate config/testnamepattern * docs(config): Translate the setupfiles.md document into Chinese. (#857) * docs(reporters): fix link formatting issues in the document * docs(reporters): fix link formatting issues in the document * docs(config): Translate the setupfiles.md document into Chinese. * docs(config): Translate the setupfiles.md document into Chinese. * docs(execargy): translate config/execargv.md (#861) * docs(execargy): translate config/execargv.md * docs(cn): update /config/execargv --------- Co-authored-by: noise <noisefan@163.com> * docs(execargy): translate config/execargv.md (#862) * docs(execargy): translate config/execargv.md (#863) * docs(cn): fix `/api/advanced/test-case` formatter (#865) Co-authored-by: 黄冬 <huangdong@huangdongs-MacBook-Pro.local> * docs(hookTimeout): translate /config/hookTimeout.md (#866) * docs(hookTimeout): translate /config/hookTimeout.md * Update config/hooktimeout.md --------- Co-authored-by: NoiseFan <noisefan@163.com> * docs(config): correct Chinese translation in themeConfig (#864) * docs(cn): update the translation of the untubeEnvs configuration document (#869) * docs(cn): Update the translation of the untubeEnvs configuration document * docs: typo * docs(locators): translate /config/browser/locators.md (#870) * docs(viewport): translate /config/browser/viewport.md (#872) * docs(cn): update /guide/brower/why (#871) * docs(screenshotDirectory): translate /config/screenshotDirectory.md (#873) --------- Co-authored-by: web3Worker-x <67700142+web3Worker-x@users.noreply.github.com> Co-authored-by: web3Worker-x <a@b.com> Co-authored-by: 韩宏广 <2421578700@qq.com> Co-authored-by: 卡 <coza17@163.com> Co-authored-by: ChengYanqi <erickcheng@163.com> Co-authored-by: WuPeiM <103431812+WuPeiM@users.noreply.github.com> Co-authored-by: faluoys <zflqljaq@gmail.com> Co-authored-by: duyidao <83811542+duyidao@users.noreply.github.com> Co-authored-by: Glue6 <70131473+Glue6@users.noreply.github.com> Co-authored-by: Kylin <75473409+lxKylin@users.noreply.github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: wshiqyuan <142188721+wshiqyuan@users.noreply.github.com> Co-authored-by: tz200 <1299799972@qq.com> Co-authored-by: thinkasany <480968828@qq.com> Co-authored-by: 草莓啵啵奶 <121411821+GitHubdinosaur@users.noreply.github.com> Co-authored-by: zyear <137589237+zero-years@users.noreply.github.com> Co-authored-by: ITHDD <37394387+Blackxoxo@users.noreply.github.com> Co-authored-by: 黄冬 <huangdong@huangdongs-MacBook-Pro.local> Co-authored-by: QmAhaha <103159950+QmAhaha@users.noreply.github.com> Co-authored-by: wshiqyuan <3453177021@qq.com>
diff --git a/.vitepress/config.ts b/.vitepress/config.ts
@@ -110,7 +110,11 @@ export default ({ mode }: { mode: string }) => {
     },
     themeConfig: {
       logo: '/logo.svg',
-
+      lastUpdatedText: '最后更新',
+      docFooter: {
+        prev: '上一页',
+        next: '下一页',
+      },
       editLink: {
         pattern: 'https://github.com/vitest-dev/docs-cn/edit/dev/:path',
         text: '在 GitHub 上编辑此页面',
@@ -212,7 +216,7 @@ export default ({ mode }: { mode: string }) => {
             collapsed: false,
             items: [
               {
-                text: 'Config File',
+                text: '配置文件',
                 link: '/config/',
               },
               {
diff --git a/api/advanced/test-case.md b/api/advanced/test-case.md
@@ -126,7 +126,7 @@ function ok(): boolean
 function meta(): TaskMeta
 ```
 
-在测试执行期间附加到测试上的自定义[元数据](/api/advanced/metadata)。我们可以在测试运行期间通过给 `ctx.task.meta` 对象分配属性来附加元数据。
+在测试执行期间附加到测试上的自定义 [元数据](/api/advanced/metadata)。我们可以在测试运行期间通过给 `ctx.task.meta` 对象分配属性来附加元数据。
 
 ```ts {3,6}
 import { test } from 'vitest'
diff --git a/config/benchmark.md b/config/benchmark.md
@@ -5,66 +5,66 @@ outline: deep
 
 # benchmark <Experimental /> {#benchmark}
 
-- **Type:** `{ include?, exclude?, ... }`
+- **类型:** `{ include?, exclude?, ... }`
 
-Options used when running `vitest bench`.
+运行 `vitest bench` 时使用的选项。
 
 ## benchmark.include
 
-- **Type:** `string[]`
-- **Default:** `['**/*.{bench,benchmark}.?(c|m)[jt]s?(x)']`
+- **类型:** `string[]`
+- **默认值:** `['**/*.{bench,benchmark}.?(c|m)[jt]s?(x)']`
 
-Include globs for benchmark test files
+匹配包含基准测试文件的 glob 规则。
 
 ## benchmark.exclude
 
-- **Type:** `string[]`
-- **Default:** `['node_modules', 'dist', '.idea', '.git', '.cache']`
+- **类型:** `string[]`
+- **默认值:** `['node_modules', 'dist', '.idea', '.git', '.cache']`
 
-Exclude globs for benchmark test files
+匹配排除基准测试文件的 glob 规则。
 
 ## benchmark.includeSource
 
-- **Type:** `string[]`
-- **Default:** `[]`
+- **类型:** `string[]`
+- **默认值:** `[]`
 
-Include globs for in-source benchmark test files. This option is similar to [`includeSource`](#includesource).
+匹配包含内联基准测试文件的 glob 规则。此选项类似于 [`includeSource`](#includesource)。
 
-When defined, Vitest will run all matched files with `import.meta.vitest` inside.
+定义后，Vitest 将运行所有匹配的文件，其中包含 `import.meta.vitest`。
 
 ## benchmark.reporters
 
-- **Type:** `Arrayable<BenchmarkBuiltinReporters | Reporter>`
-- **Default:** `'default'`
+- **类型:** `Arrayable<BenchmarkBuiltinReporters | Reporter>`
+- **默认值:** `'default'`
 
-Custom reporter for output. Can contain one or more built-in report names, reporter instances, and/or paths to custom reporters.
+用于定义输出的自定义报告器。它可以包含一个或多个内置报告名称、报告实例和(或)自定义报告的路径。
 
 ## benchmark.outputFile
 
-Deprecated in favor of `benchmark.outputJson`.
+已弃用，建议使用 `benchmark.outputJson`。
 
 ## benchmark.outputJson {#benchmark-outputJson}
 
-- **Type:** `string | undefined`
-- **Default:** `undefined`
+- **类型:** `string | undefined`
+- **默认值:** `undefined`
 
-A file path to store the benchmark result, which can be used for `--compare` option later.
+存储基准测试结果的文件路径，可用于稍后的 `--compare` 选项。
 
-For example:
+例如：
 
 ```sh
-# save main branch's result
+# 保存主分支的结果
 git checkout main
 vitest bench --outputJson main.json
 
-# change a branch and compare against main
+# 切换到另一个分支并与主分支进行比较
 git checkout feature
 vitest bench --compare main.json
 ```
 
 ## benchmark.compare {#benchmark-compare}
 
-- **Type:** `string | undefined`
-- **Default:** `undefined`
+- **类型:** `string | undefined`
+- **默认值:** `undefined`
 
-A file path to a previous benchmark result to compare against current runs.
+用于与当前运行结果进行比较的先前基准测试结果的文件路径。
diff --git a/config/browser/locators.md b/config/browser/locators.md
@@ -5,11 +5,11 @@ outline: deep
 
 # browser.locators
 
-Options for built-in [browser locators](/api/browser/locators).
+内置 [浏览器定位器](/api/browser/locators) 的选项。
 
 ## browser.locators.testIdAttribute
 
-- **Type:** `string`
-- **Default:** `data-testid`
+- **类型:** `string`
+- **默认值:** `data-testid`
 
-Attribute used to find elements with `getByTestId` locator.
+用于通过 `getByTestId` 定位器查找元素的属性。
diff --git a/config/browser/screenshotdirectory.md b/config/browser/screenshotdirectory.md
@@ -5,7 +5,7 @@ outline: deep
 
 # browser.screenshotDirectory
 
-- **Type:** `string`
-- **Default:** `__screenshots__` in the test file directory
+- **类型:** `string`
+- **默认值:** 测试文件目录中的 `__screenshots__`
 
-Path to the screenshots directory relative to the `root`.
+相对于 `root` 的屏幕截图目录路径。
diff --git a/config/browser/viewport.md b/config/browser/viewport.md
@@ -5,7 +5,7 @@ outline: deep
 
 # browser.viewport
 
-- **Type:** `{ width, height }`
-- **Default:** `414x896`
+- **类型:** `{ width, height }`
+- **默认值:** `414x896`
 
-Default iframe's viewport.
+默认 `iframe` 的视口。
diff --git a/config/execargv.md b/config/execargv.md
@@ -5,11 +5,11 @@ outline: deep
 
 # execArgv
 
-- **Type:** `string[]`
-- **Default:** `[]`
+- **类型:** `string[]`
+- **默认值:** `[]`
 
-Pass additional arguments to `node` in the runner worker. See [Command-line API | Node.js](https://nodejs.org/docs/latest/api/cli.html) for more information.
+向运行器工作线程中 `node` 传递额外参数，请参阅 [Command-line API | Node.js](https://nodejs.org/docs/latest/api/cli.html)。
 
 :::warning
-Be careful when using, it as some options may crash worker, e.g. `--prof`, `--title`. See https://github.com/nodejs/node/issues/41103.
+使用时要小心，因为某些选项（如 `--prof`、 `--title`）可能会导致 `worker` 崩溃。更多内容请参阅 https://github.com/nodejs/node/issues/41103。
 :::
diff --git a/config/fileparallelism.md b/config/fileparallelism.md
@@ -5,12 +5,12 @@ outline: deep
 
 # fileParallelism
 
-- **Type:** `boolean`
-- **Default:** `true`
-- **CLI:** `--no-file-parallelism`, `--fileParallelism=false`
+- **类型:** `boolean`
+- **默认值:** `true`
+- **命令行终端:** `--no-file-parallelism`, `--fileParallelism=false`
 
-Should all test files run in parallel. Setting this to `false` will override `maxWorkers` option to `1`.
+所有测试文件应该并行运行。 将其设置为 `false` 将覆盖 `maxWorkers` 选项为 `1`。
 
 ::: tip
-This option doesn't affect tests running in the same file. If you want to run those in parallel, use `concurrent` option on [describe](/api/#describe-concurrent) or via [a config](#sequence-concurrent).
+此选项不会影响在同一文件中运行的测试。如果你想并行运行这些程序，使用 `concurrent` 选项 [describe](/api/#describe-concurrent) 或通过 [配置](#sequence-concurrent)。
 :::
diff --git a/config/hooktimeout.md b/config/hooktimeout.md
@@ -5,8 +5,8 @@ outline: deep
 
 # hookTimeout
 
-- **Type:** `number`
-- **Default:** `10_000` in Node.js, `30_000` if `browser.enabled` is `true`
-- **CLI:** `--hook-timeout=10000`, `--hookTimeout=10000`
+- **类型:** `number`
+- **默认值:** 在 Node.js 环境下为 `10_000`，当 `browser.enabled` 为 `true` 时为 `30_000`
+- **命令行终端:** `--hook-timeout=10000`，`--hookTimeout=10000`
 
-Default timeout of a hook in milliseconds. Use `0` to disable timeout completely.
+钩子 (`hook`) 的默认超时时间 （以毫秒为单位）。使用 `0` 完全禁用超时。
diff --git a/config/index.md b/config/index.md
@@ -2,7 +2,7 @@
 outline: deep
 ---
 
-# 配置索引 {#configuring-vitest}
+# 配置 Vitest {#configuring-vitest}
 
 如果我们正在使用 Vite 并且拥有一个 `vite.config` 文件，Vitest 会读取它来匹配我们的 Vite 应用的插件和设置。如果我们想要为测试配置不同的设置，或者我们的并不特别依赖于 Vite，我们我们可以选择：
 
diff --git a/config/runner.md b/config/runner.md
@@ -5,7 +5,7 @@ outline: deep
 
 # runner
 
-- **Type**: `VitestRunnerConstructor`
-- **Default**: `node`, when running tests, or `benchmark`, when running benchmarks
+- **类型**: `VitestRunnerConstructor`
+- **默认值**: 运行测试时为 `node`，运行基准测试时为 `benchmark`
 
-Path to a custom test runner. This is an advanced feature and should be used with custom library runners. You can read more about it in [the documentation](/api/advanced/runner).
+自定义测试运行器的路径。这是一项高级功能，应与自定义库运行器一起使用。你可以在 [文档](/api/advanced/runner) 中阅读更多相关信息。
diff --git a/config/setupfiles.md b/config/setupfiles.md
@@ -5,21 +5,21 @@ outline: deep
 
 # setupFiles
 
-- **Type:** `string | string[]`
+- **类型:** `string | string[]`
 
-Path to setup files. They will be run before each test file.
+setup 文件的路径。它们将在每个测试文件之前运行。
 
 :::info
-Editing a setup file will automatically trigger a rerun of all tests.
+编辑设置文件将自动触发所有测试的重新运行。
 :::
 
-You can use `process.env.VITEST_POOL_ID` (integer-like string) inside to distinguish between workers.
+你可以在全局设置文件中使用 `process.env.VITEST_POOL_ID`（类似整数的字符串）来区分不同的线程。
 
 :::tip
-Note, that if you are running [`--isolate=false`](#isolate), this setup file will be run in the same global scope multiple times. Meaning, that you are accessing the same global object before each test, so make sure you are not doing the same thing more than you need.
+请注意，如果运行 [`--isolate=false`](#isolate)，这个配置文件将在全局范围内多次运行。这意味着每次测试前都要访问同一个全局对象，因此请确保不要重复做同一件事。
 :::
 
-For example, you may rely on a global variable:
+比如，你可能依赖于一个全局变量：
 
 ```ts
 import { config } from '@some-testing-lib'
@@ -30,7 +30,7 @@ if (!globalThis.defined) {
   globalThis.defined = true
 }
 
-// hooks are reset before each suite
+// 钩子函数会在每个测试套件前重置
 afterEach(() => {
   cleanup()
 })
diff --git a/config/testnamepattern.md b/config/testnamepattern.md
@@ -5,21 +5,20 @@ outline: deep
 
 # testNamePattern <CRoot /> {#testnamepattern}
 
-- **Type** `string | RegExp`
-- **CLI:** `-t <pattern>`, `--testNamePattern=<pattern>`, `--test-name-pattern=<pattern>`
+- **类型** `string | RegExp`
+- **命令行终端** `-t <pattern>`, `--testNamePattern=<pattern>`, `--test-name-pattern=<pattern>`
 
-Run tests with full names matching the pattern.
-If you add `OnlyRunThis` to this property, tests not containing the word `OnlyRunThis` in the test name will be skipped.
+运行符合全名匹配的测试。如果在此属性中添加 `OnlyRunThis`，则测试中不包含 `OnlyRunThis` 关键字的用例将会被跳过。
 
 ```js
 import { expect, test } from 'vitest'
 
-// run
+// 运行
 test('OnlyRunThis', () => {
   expect(true).toBe(true)
 })
 
-// skipped
+// 跳过
 test('doNotRun', () => {
   expect(true).toBe(true)
 })
diff --git a/config/testtimeout.md b/config/testtimeout.md
@@ -5,8 +5,8 @@ outline: deep
 
 # testTimeout
 
-- **Type:** `number`
-- **Default:** `5_000` in Node.js, `15_000` if `browser.enabled` is `true`
-- **CLI:** `--test-timeout=5000`, `--testTimeout=5000`
+- **类型:** `number`
+- **默认值:** 在 Node.js 环境下为 `5_000`，当 `browser.enabled` 为 `true` 时为 `15_000`
+- **命令行终端:** `--test-timeout=5000`, `--testTimeout=5000`
 
-Default timeout of a test in milliseconds. Use `0` to disable timeout completely.
+测试的默认超时时间（以毫秒为单位）。 使用 `0` 完全禁用超时。
diff --git a/config/unstubenvs.md b/config/unstubenvs.md
@@ -5,10 +5,10 @@ outline: deep
 
 # unstubEnvs
 
-- **Type:** `boolean`
-- **Default:** `false`
+- **类型:** `boolean`
+- **默认值:** `false`
 
-Should Vitest automatically call [`vi.unstubAllEnvs()`](/api/vi#vi-unstuballenvs) before each test.
+将在每次测试前调用 [`vi.unstubAllEnvs()`](/api/vi#vi-unstuballenvs)。
 
 ```js [vitest.config.js]
 import { defineConfig } from 'vitest/config'
diff --git a/config/watch.md b/config/watch.md
@@ -5,12 +5,12 @@ outline: deep
 
 # watch <CRoot /> {#watch}
 
-- **Type:** `boolean`
-- **Default:** `!process.env.CI && process.stdin.isTTY`
-- **CLI:** `-w`, `--watch`, `--watch=false`
+- **类型:** `boolean`
+- **默认值:** `!process.env.CI && process.stdin.isTTY`
+- **命令行终端:** `-w`, `--watch`, `--watch=false`
 
-Enable watch mode
+启动监听模式
 
-In interactive environments, this is the default, unless `--run` is specified explicitly.
+交互式环境中，默认启用监听模式，除非显式传入 `--run`。
 
-In CI, or when run from a non-interactive shell, "watch" mode is not the default, but can be enabled explicitly with this flag.
+在 CI 或非交互式 shell 中，监听模式默认关闭，但可通过该标志显式启用。
diff --git a/guide/advanced/reporters.md b/guide/advanced/reporters.md
@@ -14,7 +14,7 @@
 import { DefaultReporter } from 'vitest/reporters'
 
 export default class MyDefaultReporter extends DefaultReporter {
-  // do something
+  // 在此实现自定义功能
 }
 ```
 
diff --git a/guide/browser/why.md b/guide/browser/why.md
@@ -6,8 +6,7 @@ outline: deep
 # 什么是浏览器模式? {#why-browser-mode}
 
 ## 动机 {#motivation}
-<!-- TODO: translation -->
-We developed the Vitest browser mode feature to help improve testing workflows and achieve more accurate and reliable test results. This addition to our testing API allows developers to run tests in a native browser environment. In this section, we'll explore the motivations behind this feature and its benefits for testing.
+我们开发了 Vitest 浏览器模式功能，以帮助改进测试工作流程并实现更准确、可靠的测试结果。这个实验性的测试 API 增加了在本地浏览器环境中运行测试的功能。本节将深入探讨该功能的开发初衷以及其为测试工作带来的优势。
 
 ### 不同的测试方式 {#different-ways-of-testing}
 
diff --git a/guide/coverage.md b/guide/coverage.md
@@ -464,7 +464,7 @@ export function ignored() { // [!code error]
 
 ## 覆盖率性能 {#coverage-performance}
 
-如果你的项目中代码覆盖率生成较慢，请参阅[性能测试分析 | 代码覆盖率](/guide/profiling-test-performance.html#code-coverage)。
+如果你的项目中代码覆盖率生成较慢，请参阅 [性能测试分析 | 代码覆盖率](/guide/profiling-test-performance.html#code-coverage)。
 
 ## UI 模式 {#vitest-ui}
 
diff --git a/guide/mocking/classes.md b/guide/mocking/classes.md
@@ -74,7 +74,7 @@ import { Dog } from './dog.js'
 vi.mock(import('./dog.js'), () => {
   const Dog = vi.fn(class {
     feed = vi.fn()
-    // ... other mocks
+    // 模拟其他内容...
   })
   return { Dog }
 })
@@ -154,5 +154,5 @@ expect(nameSpy).toHaveBeenCalledTimes(1)
 :::
 
 ::: danger
-在 Vitest 4 中引入了使用 `vi.fn()` 模拟类的功能。在此之前，你必须直接使用 `function` 和 `prototype` 继承。参见 [v3 指南](https://v3.vitest.dev/guide/mocking.html#classes)。
+在 Vitest 4 中引入了使用 `vi.fn()` 模拟类的功能。在此之前，你必须直接使用 `function` 和 `prototype` 继承。参见 [v3 指南](https://v3.cn.vitest.dev/guide/mocking.html#classes)。
 :::
diff --git a/guide/reporters.md b/guide/reporters.md
@@ -635,10 +635,10 @@ export default defineConfig({
 
 :::
 
-此外，你还可以定义自己的[自定义报告器](/guide/advanced/reporters)，并通过指定文件路径来使用它们:
+此外，你还可以定义自己的 [自定义报告器](/guide/advanced/reporters)，并通过指定文件路径来使用它们:
 
 ```bash
 npx vitest --reporter=./path/to/reporter.ts
 ```
 
-自定义报告器应实现[报告器接口](https://github.com/vitest-dev/vitest/blob/main/packages/vitest/src/node/types/reporter.ts)。
+自定义报告器应实现 [报告器接口](https://github.com/vitest-dev/vitest/blob/main/packages/vitest/src/node/types/reporter.ts)。
