devRestart(options)

监听 Vite 模块图之外的配置、schema 或生成输入，在变化时防抖重启开发服务器。

devRestart({
	paths: ["schema", "config/features.json"],
	debounce: 100,
	beforeRestart: async ({ file, event }) => auditChange(file, event),
});

选项	默认值	说明
paths	必填	相对 Vite root 或绝对文件/目录；不支持 glob
debounce	100	合并连续文件事件的毫秒数
forceOptimizeDeps	false	重启时是否强制重新执行依赖预构建
beforeRestart	-	重启前同步/异步钩子；抛错会取消本次重启
log	true	输出最后一次触发重启的相对路径

启动时存在的目录会匹配其后代；启动时不存在的路径按单个精确文件处理。Vite 已原生监听自己的配置和 .env，无需重复加入。

devRestart 自动重启

在外部配置、代码生成输入或 monorepo 共享文件变化时重启 Vite 开发服务器。

Vite 已经原生监听 vite.config 与 .env，无需重复配置这些文件。本插件适用于 Vite 模块图之外、但会影响插件初始化结果的文件。生产构建不会注册任何监听器。

签名

export function devRestart(options: DevRestartPluginOptions): Plugin;

示例

import { devRestart } from "fast-vite-plugins";

const plugin = devRestart({ paths: ["schema", "config/features.json"], debounce: 100 });

export default { plugins: [plugin] };

输入

输入值	输入值类型	必填/默认值	输入值说明
options	DevRestartPluginOptions	是	监听路径、防抖、依赖预构建和重启前钩子配置。

返回

返回值	返回值类型	返回值说明
plugin	Plugin	仅在开发服务器中生效的 Vite 重启插件。