feat: add enabled plugin options

Author: pengzhanbo

README.md

@@ -187,6 +187,14 @@ export default defineMock({
 
 ## Plugin Options
 
+### enabled
+
+- **Type:** `boolean`
+- **Default:** `true`
+- **Details:**
+
+  Whether to enable mock server, if set to `false`, the plugin will not work.
+
 ### prefix
 
 - **Type:** `string | string[]`

README.zh-CN.md

@@ -188,6 +188,14 @@ export default defineMock({
 
 ## Plugin Options
 
+### enabled
+
+- **类型：** `boolean`
+- **默认值：** `true`
+- **详情：**
+
+  是否开启 mock 服务。如果设置为 `false`，插件将不会生效。
+
 ### prefix
 
 - **类型：** `string | string[]`

docs/en/api/mock-server-plugin-options.md

@@ -6,6 +6,7 @@ Plugin configuration options interface, used to configure the behavior of Mock D
 
 ```ts
 interface MockServerPluginOptions {
+  enabled?: boolean
   prefix?: string | string[]
   wsPrefix?: string | string[]
   cwd?: string
@@ -25,6 +26,12 @@ interface MockServerPluginOptions {
 
 ## Property Details
 
+### enabled
+
+- **Type**: `boolean`
+- **Default**: `true`
+- **Description**: Whether to enable Mock server, if set to `false`, the plugin will not work.
+
 ### prefix
 
 - **Type**: `string | string[]`

docs/en/guide/plugin-config.md

@@ -23,6 +23,7 @@ export default defineConfig({
 
 | Configuration | Type | Default | Description |
 | ------------- | ---- | ------- | ----------- |
+| [enabled](../api/mock-server-plugin-options#enabled) | `boolean` | `true` | Whether to enable Mock server |
 | [prefix](../api/mock-server-plugin-options#prefix) | `string \| string[]` | `[]` | HTTP Mock path prefix |
 | [wsPrefix](../api/mock-server-plugin-options#wsprefix) | `string \| string[]` | `[]` | WebSocket path prefix |
 | [cwd](../api/mock-server-plugin-options#cwd) | `string` | `process.cwd()` | Working directory |

docs/zh/api/mock-server-plugin-options.md

@@ -6,6 +6,7 @@
 
 ```ts
 interface MockServerPluginOptions {
+  enabled?: boolean
   prefix?: string | string[]
   wsPrefix?: string | string[]
   cwd?: string
@@ -27,6 +28,12 @@ interface MockServerPluginOptions {
 
 ## 属性详解
 
+### enabled
+
+- **类型**: `boolean`
+- **默认值**: `true`
+- **描述**: 是否开启 Mock 服务，设置为 `false` 时插件将不生效。
+
 ### prefix
 
 - **类型**: `string | string[]`

docs/zh/guide/plugin-config.md

@@ -23,6 +23,7 @@ export default defineConfig({
 
 | 配置项 | 类型 | 默认值 | 说明 |
 | ------ | ---- | ------ | ---- |
+| [enabled](../api/mock-server-plugin-options#enabled) | `boolean` | `true` | 是否开启 Mock 服务 |
 | [prefix](../api/mock-server-plugin-options#prefix) | `string \| string[]` | `[]` | HTTP Mock 路径前缀 |
 | [wsPrefix](../api/mock-server-plugin-options#wsprefix) | `string \| string[]` | `[]` | WebSocket 路径前缀 |
 | [cwd](../api/mock-server-plugin-options#cwd) | `string` | `process.cwd()` | 工作目录 |

vite-plugin-mock-dev-server/src/core/plugin.ts

@@ -18,6 +18,9 @@ import { resolvePluginOptions, resolveRecordOptions } from './options'
  * @returns Array of Vite plugin objects / Vite 插件对象数组
  */
 export function mockDevServerPlugin(options: MockServerPluginOptions = {}): Plugin[] {
+  if (options.enabled === false)
+    return []
+
   const plugins: Plugin[] = [serverPlugin(options)]
   if (options.build)
     plugins.push(buildPlugin(options))

vite-plugin-mock-dev-server/src/types/options.ts

@@ -148,6 +148,14 @@ export interface MockServerPluginOptions {
    */
   wsPrefix?: string | string[]
 
+  /**
+   * Whether to enable mock server
+   *
+   * 是否开启 mock 服务
+   * @default true
+   */
+  enabled?: boolean
+
   /**
    * Configure the matching context for `include` and `exclude`.
    *