trunk serve热重载失效求助：本地开发无法自动更新页面

1. 优先更新Trunk版本 #

旧版本Trunk存在热重载逻辑的已知bug，先确认当前版本：

trunk --version

如果不是最新稳定版，执行强制更新：

cargo install trunk --force

2. 核对项目配置与监听范围 #

• Trunk默认监听项目根目录的index.html、Cargo.toml以及src/下的所有文件。确保你的入口HTML是根目录的index.html，若使用自定义入口，需在Trunk.toml中明确配置：

  [build]
  target = "index.html" # 替换为你的实际入口文件路径
  

• 检查Trunk.toml中是否存在禁用热重载的配置，比如watch = false，需将其改为watch = true或直接删除该配置项。

3. 修正cargo watch的使用方式 #

你之前的cargo watch -c -- trunk serve会导致重复启动Trunk服务，引发无限重载和连接问题。正确的做法是拆分任务：

• 终端1：启动Trunk负责托管与热重载

  trunk serve
  

• 终端2：用cargo watch监听Rust代码变化，触发构建

  cargo watch -w src -s "trunk build"
  

4. 排除浏览器缓存干扰 #

修改HTML后刷新页面无变化，大概率是浏览器缓存了旧资源：

• 强制刷新页面：Windows/Linux用Ctrl+Shift+R，macOS用Cmd+Shift+R
• 打开浏览器开发者工具（F12），在Network面板勾选「Disable cache」，避免后续缓存问题

5. 检查系统监听限制与文件权限 #

• Linux/macOS：系统inotify监听上限不足会导致Trunk无法检测文件变化，执行以下命令查看并调整：

  # 查看当前上限
  sysctl fs.inotify.max_user_watches
  # 临时调高上限（重启后失效）
  sudo sysctl fs.inotify.max_user_watches=524288
  # 永久生效（写入配置文件）
  echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
  

• Windows：确保项目文件夹没有被系统权限保护，Trunk拥有读取文件的权限。

6. 用最小化项目验证 #

如果以上方法都无效，创建一个极简的Rust WASM项目测试热重载是否正常：

1. 初始化项目：

   cargo new --lib wasm-test
   cd wasm-test
   

2. 修改Cargo.toml：

   [lib]
   crate-type = ["cdylib", "rlib"]
   
   [dependencies]
   wasm-bindgen = "0.2"
   

3. 新建index.html：

   <!DOCTYPE html>
   <html>
     <body>
       <h1>Test Hot Reload</h1>
       <script type="module">
         import init from './pkg/wasm_test.js';
         init();
       </script>
     </body>
   </html>
   

4. 启动Trunk：

   trunk serve
   

修改index.html的标题或src/lib.rs的代码，观察页面是否自动重载。如果这个最小项目正常，说明原项目存在依赖冲突或配置异常。

内容的提问来源于stack exchange，提问作者John M.T.