You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

WSL2环境下默认Svelte项目的HMR功能无法正常工作

WSL2环境下Svelte Kit HMR失效的解决办法
  • 修改Vite配置适配WSL2文件监听
    在项目根目录的vite.config.js(或vite.config.ts)中添加以下配置,解决WSL2的文件系统监听限制,同时允许外部访问:

    import { sveltekit } from '@sveltejs/kit/vite';
    import { defineConfig } from 'vite';
    
    export default defineConfig({
        plugins: [sveltekit()],
        server: {
            host: '0.0.0.0',
            watch: {
                usePolling: true
            }
        }
    });
    
  • 避免在Windows挂载目录创建项目
    不要将项目放在/mnt/c、/mnt/d这类Windows磁盘挂载的目录下,直接在WSL原生文件系统(比如~/projects)里创建和运行项目——跨系统文件系统的监听机制存在兼容性问题,会导致HMR无法触发。

  • 更新相关依赖版本
    执行命令更新Vite和Svelte Kit依赖,确保使用的版本修复了WSL2下的HMR已知问题:

    npm update @sveltejs/kit vite
    
  • 确认端口与防火墙设置
    启动dev服务后,检查本地Windows防火墙是否允许默认端口(5173)的入站连接,同时确保WSL2的端口转发正常,能通过WSL IP访问服务。

内容的提问来源于stack exchange,提问作者Rahul K.

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.11 05:50:55