Remix项目断点不命中因source map路径未对齐，需在launch.json中配置"resolveSourceMapLocations"并禁用concurrently/nodemon；loader/action类型报错因TS未加载@remix-run/dev声明，须在tsconfig.json的"types"中显式添加该包。
Remix项目断点不命中：source map路径没对上
VSCode调试时断点显示空心圆，本质是调试器找不到源码映射文件。Remix用esbuild生成代码，默认带inlineSourceMap，但VSCode的Node调试器需要明确告诉它“去哪找源文件”。launch.json里光写"sourceMaps": true不够，必须加"resolveSourceMapLocations"并限定范围。
- 确保
.vscode/launch.json中配置包含："resolveSourceMapLocations": ["${workspaceFolder}/**", "!**/node_modules/**"] - 不要用
concurrently或nodemon包装remix dev命令——它们会fork子进程，VSCode attach不到真实Node实例 - 检查
remix.config.ts是否禁用了future.v3_routeConvention等实验性选项，某些组合会导致source map输出路径异常
loader/action类型报错：TypeScript没加载Remix声明
写export function loader()时提示Cannot find name 'loader'，不是VSCode问题，而是TS语言服务根本没读到Remix的类型增强。Remix v2+把类型定义放在@remix-run/dev包里，且必须显式引入才能激活。
- 在
tsconfig.json的"types"数组中加入"@remix-run/dev"（不是@remix-run/node） - 确认
node_modules/@remix-run/dev/index.d.ts存在；若用pnpm，检查.pnpm链接是否损坏，可临时npm install验证 - 在任意路由文件顶部加一行
import "@remix-run/dev";——仅用于触发类型注册，运行时不会执行
JSX高亮错乱或CSS-in-JS失效：VSCode不跑Babel插件
Emotion、styled-components这类库依赖Babel插件（如@emotion/babel-plugin-jsx-pragmatic）注入css prop，但VSCode语法检查器只走TS解析，不执行Babel转换，所以css属性没类型、JSX结构被误判。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 这不是配置错误，是工具链分工导致的——VSCode负责静态分析，Babel负责运行时转换
- 高亮问题可忽略，只要
tsc --noEmit能通过，说明类型没问题；样式失效则检查remix.config.ts中postcss和tailwind插件是否启用 - 若需实时预览样式，用
Live Server插件打开public/build目录，而非直接看.tsx文件
entry.client.tsx改了不热更新：HMR监听范围太窄
修改app/entry.client.tsx后页面没刷新，是因为Remix的HMR默认只监听路由模块和app/root.tsx，entry.client.tsx不在默认watch列表里。
- 在
remix.config.ts中手动扩展watchPaths：watchPaths: ["app/entry.client.tsx"] - 避免直接改
entry.client.tsx逻辑——它只应做hydrate，业务代码移到root或布局组件里 - 如果用了
import * as React from "react"这种写法，某些TS版本会干扰HMR，改用import React from "react"
Remix的调试配置关键不在“怎么启动”，而在“谁在控制进程生命周期”——VSCode调试器必须直连remix dev主进程，任何中间层都会破坏source map链路；类型支持则完全依赖@remix-run/dev的声明文件是否被TS引擎实际加载，而不是装没装包。
