如何在macOS上配置Rancher Desktop解决Vite服务器热重载过慢问题

1. 缩小Vite轮询间隔 #

默认轮询间隔可能过大，直接修改vite.config.js里的轮询参数，缩短文件变更检测周期：

export default defineConfig({
    server: {
        hmr: {
            protocol: 'ws',
            host: '0.0.0.0',
            port: 5173,
            poll: 1000 // 改为1秒一次轮询
        },
        watch: {
            usePolling: true,
            interval: 1000
        }
    },
    // 保留其他原有配置
});

2. 切换Rancher Desktop文件共享模式 #

Rancher Desktop默认的VirtioFS可能存在文件变更通知延迟问题，切换到gRPC FUSE模式：

• 打开Rancher Desktop设置
• 进入「Virtual Machine」→「File Sharing」
• 选择「gRPC FUSE」选项，重启Rancher Desktop生效

3. 优化容器挂载参数 #

在Laravel Sail的docker-compose.yml中，给项目目录挂载添加:delegated参数，提升文件同步效率：

services:
    laravel.test:
        volumes:
            - '.:/var/www/html:delegated' # 添加:delegated
        # 其他配置不变

:delegated让容器优先使用本地缓存，主机文件变更后延迟同步到容器，完全适配开发场景下的热重载需求。

4. 禁用Vite文件系统缓存（可选） #

如果上述方法仍有延迟，可尝试关闭Vite的缓存目录，强制每次检测文件真实状态：

export default defineConfig({
    server: {
        // 保留之前的server配置
    },
    cacheDir: false // 禁用缓存目录
});

内容的提问来源于stack exchange，提问作者Martin Cmarko