Remix路由调试必须用JavaScript Debug配置而非Node.js，因loader/action运行在浏览器上下文；需配置正确URL、启用Chrome及JetBrains插件，并确保source map加载成功、断点设在dev模式源码中。
Remix路由调试必须用 JavaScript Debug 配置，不是 Node.js
WebStorm 默认不会为 Remix 项目自动创建正确的调试配置，很多人误选 Node.js 类型导致断点完全不生效——Remix 的开发服务器（remix dev）本质是 Node 进程，但前端路由逻辑运行在浏览器上下文，必须走浏览器调试通道。
- 新建 Run/Debug Configuration → 选择
JavaScript Debug（中文菜单叫“JavaScript 调试”），不是Node.js或npm - URL 填
http://localhost:3000（或你实际启动的端口），确保和remix dev输出的地址一致 - 勾选
Open in browser，并指定 Chrome（需已安装 JetBrains IDE Support 插件） - 若项目启用了 HTTPS 或自定义 host，WebStorm 内置服务（
http://localhost:63342/）无法代理，必须用真实服务地址
断点打在 loader/action 里没反应？检查 sourcemap 和构建模式
Remix 默认开启 dev 模式，但如果你手动改过 remix.config.js 或用了自定义构建脚本，可能关掉了 sourcemap，导致浏览器无法映射到源码行。
在SEO发布前，从路由清单生成XML网站地图和robots.txt
下载
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
- 确认
remix.config.js中未设置buildEnd或覆盖devServer行为；默认配置下 loader/action 文件应直接可断点 - 打开 Chrome DevTools → Sources → 看左侧是否能展开
app/routes/**目录，且文件名后带(webpack)或(remix)标识 —— 没有说明 sourcemap 未加载 - Network 面板中查找
.js.map请求，状态码必须是200；返回404就要检查remix dev是否正常启动、是否有路径别名冲突 - 避免在
build后的产物上设断点，Remix 的生产构建会混淆代码，loader/action 断点只对dev有效
useLoaderData() 返回 undefined？别只看悬停，查执行上下文
Remix 的 loader 执行时机和组件渲染解耦，常出现「断点进了 loader，但组件里 useLoaderData() 是 undefined」——这不是 WebStorm 显示问题，而是 loader 没返回值或被重定向拦截。
- loader 函数必须显式
return一个对象或 Promise，空 return / 无 return / throw 未被捕获都会导致useLoaderData()为空 - 检查 loader 内部是否有同步抛错（如未 await 的 fetch）、或
redirect()/json()以外的响应构造方式 - 在 loader 断点暂停时，右键变量 →
Evaluate Expression输入response或await response.json()（如果 fetch 了），验证实际返回内容 - Chrome Network 面板过滤
X-Remix-Route请求，看对应 route 的 loader 请求是否返回 200 + 正确 JSON
嵌套路由跳转后断点失效？启用 iframe 调试支持
Remix 的 <outlet></outlet> 渲染子路由时，若页面包含 iframe（比如嵌入文档预览、第三方 widget），WebStorm 默认不监听其内部 JS 执行，导致子路由 loader/action 断点不触发。
- Settings → Tools → JavaScript → Debugger → Webkit → 勾选
Enable debugging for iframes - 重启调试会话，否则新设置不生效
- 若使用
createBrowserRouter自定义 router（非 Remix 默认），需确保window.location变更能触发 WebStorm 路由监听，否则建议退回createRemixRouter - Service Worker 干扰时（如 PWA 模式），同样勾选
Enable debugging for service workers，并在 Application → Service Workers 中禁用 “Update on reload” 避免缓存干扰
