> For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt.

# isolate

- **类型：** `boolean`
- **默认值：** `true`
- **CLI：** `--isolate`, `--isolate=false`, `--no-isolate`

是否运行每个测试在一个独立的环境。

默认情况下，Rstest 会运行每个测试在一个独立的环境，这会使其避免受到一些模块副作用的影响，从而有助于提升测试的稳定性。

如果你的代码没有副作用影响，关闭这个选项将有助于提升性能因为可以在不同的测试文件间复用模块缓存。

:::info `vmForks` 和 `vmThreads` 始终按文件隔离
当 [`pool.type`](/zh/config/test/pool.md#vmforks) 为 `vmForks` 或 `vmThreads` 时，此选项不生效。Rstest 会复用 worker，但会为每个文件创建新的 VM context、module graph 和 test environment。因此，setup 文件和 worker scope fixture 也仍保持文件级生命周期。
:::

:::warning 模块顶层代码每个 worker 只执行一次
对于 `forks` 和 `threads`，当 `isolate` 为 `false` 时，被多个测试文件引入的模块在每个 worker 中**只会被求值一次**，而非每个文件求值一次。因此该共享模块顶层的所有代码——包括在其模块作用域注册的 hooks（例如某个 helper 在模块作用域调用 `beforeEach`）——只会对第一个加载它的文件生效，而不会对每个文件生效。如果某段 setup 逻辑需要按文件执行，请使用 [`setupFiles`](/zh/config/test/setup-files.md)，即使关闭隔离，Rstest 也会为每个测试文件重新执行它。[测试环境](/zh/config/test/test-environment.md)遵循同样的规则——它在每个 worker 中只创建一次，其状态（DOM、未清理的 timer、已安装的 fake timers）会跨文件保留，可在 `setupFiles` 中按文件重置。
:::


**CLI**

```bash
npx rstest --no-isolate
```


**rstest.config.ts**

```ts
import { defineConfig } from '@rstest/core';

export default defineConfig({
  isolate: false,
});
```