jsconfig.json必须放在项目根目录（与package.json同级），vscode仅从此处读取；baseurl须设为"."，paths的key必须含""如"@/"，value为数组且路径相对baseurl如["src/*"]；改配置后需手动重启ts server。
jsconfig.json 必须放在项目根目录
VSCode 只从工作区根目录（即 package.json 所在目录）读取 jsconfig.json 或 tsconfig.json。放错位置等于没配。
- ❌ 错误路径：
src/jsconfig.json、./config/jsconfig.json—— 完全不生效 - ✅ 正确路径：
./jsconfig.json（与package.json同级） - 多根工作区需每个文件夹单独配，或统一用
.vscode/settings.json补"typescript.preferences.includePackageJsonAutoImports": "auto"
baseUrl 和 paths 的写法陷阱
baseUrl 是解析别名的起点，paths 的 key/value 必须严格匹配语义，稍错就失效。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
-
baseUrl必须是"."（不能是"./"、""或"src"） - key 必须含通配符
*：如"@/*"✅，"@/"❌（后者无法匹配@/utils/foo） - value 是数组，且路径相对
baseUrl：如"@/*": ["src/*"]✅，"@/*": ["./src/*"]❌（./在paths中非法） - Webpack/Vite 的
resolve.alias是绝对路径，但 VSCode 的paths是相对路径 —— 二者语义要对齐，不是值一样就行
改完配置后跳转仍不生效
VSCode 不自动重载 TypeScript 语言服务，旧缓存会持续干扰，必须手动触发。
- 快捷键：
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）→ 输入TypeScript: Restart TS Server→ 回车 - 右下角状态栏应显示 “TypeScript x.x.x”，若显示 “JavaScript”，说明当前文件未被 TS 服务接管（检查
include或allowJs） - 禁用 Path Intellisense 插件的
path-intellisense.mappings配置 —— 它会覆盖jsconfig.json，造成冲突 - 确认
gitignore没忽略jsconfig.json；多人协作时，该文件必须提交
构建能跑 ≠ 编辑器能跳转
Webpack/Vite 的 resolve.alias 只影响打包时模块解析，VSCode 的路径跳转完全依赖 jsconfig.json，两者无任何自动同步机制。
- Vite 项目示例：
vite.config.ts里写{ '@': path.resolve(__dirname, 'src') }，对应jsconfig.json里就得是"@/*": ["src/*"] - Vue + Volar 用户注意：
vue-tsc和 Volar 插件可能各自缓存，需同时重启 TS Server 和 Volar - 最常被忽略的一点：即使你只改了一处
@/引用，只要jsconfig.json里paths少一个*，整个别名链就断了，且无任何报错提示
