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

# VirtualModulesPlugin


[Added in v1.5.0](https://github.com/web-infra-dev/rspack/releases/tag/v1.5.0)Rspack only

`VirtualModulesPlugin` 允许你在内存中创建、修改和删除文件，Rspack 会将这些虚拟文件视为真实存在于文件系统中的文件进行处理。

该插件是 [webpack-virtual-modules](https://github.com/sysgears/webpack-virtual-modules) 的 Rust 实现版本，与 Rspack 深度集成，在提供相同功能的同时拥有更好的性能。

## 示例

### 基础用法

创建 `VirtualModulesPlugin` 实例时，可以在构造函数中直接配置虚拟模块：

```ts
import { rspack } from '@rspack/core';

new rspack.experiments.VirtualModulesPlugin({
  // ...modules
});
```

```js title="rspack.config.mjs"
import { rspack } from '@rspack/core';

export default {
  plugins: [
    new rspack.experiments.VirtualModulesPlugin({
      'src/generated/config.js': 'export default { version: "1.0.0" };',
      'src/generated/constants.js': `
        export const API_URL = "${process.env.API_URL || 'http://localhost:3000'}";
        export const DEBUG = ${process.env.NODE_ENV !== 'production'};
      `,
    }),
  ],
};
```

### 动态模块创建

你可以使用 `writeModule` 方法动态创建或修改虚拟模块。

:::note
因为插件的虚拟模块是在 Rust 侧管理的，所以 `writeModule` 方法只有在 Rust 编译器初始化后才可用。
例如，在 `beforeCompile` 或 `compile` 钩子中调用 `writeModule` 会抛出以下错误：`Error: Virtual file store has not been initialized.`
:::

- **类型：**

```ts
function writeModule(filePath: string, contents: string): void;
```

- **参数：**
  - `filePath`：相对于 [compiler.context](/zh/api/javascript-api/compiler.md#context) 的虚拟文件路径
  - `contents`：虚拟文件的内容

- **示例：**

```js title="rspack.config.mjs"
import { rspack } from '@rspack/core';

const virtualModulesPlugin = new rspack.experiments.VirtualModulesPlugin();

export default {
  plugins: [
    virtualModulesPlugin,
    {
      apply(compiler) {
        compiler.hooks.thisCompilation.tap('MyPlugin', () => {
          // 动态创建模块
          const moduleContent = generateSomeContent();
          virtualModulesPlugin.writeModule('src/dynamic.js', moduleContent);
        });
      },
    },
  ],
};
```

## 选项

- **类型：** `Record<string, string>`
- **默认值：** `{}`

可选的构造函数参数将每个虚拟文件路径映射到对应的文件内容。路径相对于 [compiler.context](/zh/api/javascript-api/compiler.md#context) 解析。