VSCode不内置Lerna支持，核心是确保终端、调试器、类型服务和任务系统在monorepo中正确对齐环境变量、工作目录及TS路径映射；lerna报command not found主因是终端PATH未包含node_modules/.bin，应优先用npx调用并检查defaultProfile与cwd配置。
VSCode 本身不提供 Node 运行时或 Lerna 支持，所谓“配置”其实是让终端、调试器、类型服务和任务系统在 monorepo 场景下能正确找到 node、npx lerna 和本地包路径——核心是环境变量、工作目录和 TypeScript 路径映射三者对齐。
终端里 lerna 报 command not found 怎么办
这不是 Lerna 没装，而是 VSCode 启动的终端没加载项目 node_modules/.bin 路径。尤其用 pnpm/yarn 的 monorepo，lerna 只装在根目录，但 shell 的 PATH 里没有它。
- 先在项目根目录运行
npx lerna --version，成功说明已安装，纯属路径问题 - 检查 VSCode 设置：
terminal.integrated.defaultProfile是否指向你日常用的 shell（如zsh或bash）；Windows 用户常误设为 PowerShell，导致环境变量不一致 - 别往
~/.zshrc里硬加./node_modules/.bin—— 这只对当前目录生效，且有安全风险 - 统一用
npx lerna执行命令最稳妥；如果坚持用全局命令，确保是本地安装：npm install lerna --save-dev，而非npm install -g lerna
launch.json 调试 Lerna 源码时断点不命中
VSCode 的 vscode-js-debug 找不到源码映射，常见于 program 指向错误、未启用 type: "module" 或 source map 缺失。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- Lerna 入口文件是
core/lerna/cli.js，program必须精确指向它："${workspaceFolder}/core/lerna/cli.js" - 若项目用了 ES Module 语法（
import），但package.json没配"type": "module"，Node 会按 CommonJS 解析，路径错乱导致断点失效 - 确认
cli.js同级有cli.js.map，且 launch.json 中outFiles包含该路径，例如："outFiles": ["${workspaceFolder}/core/**/*.js"] - 避免在
program里写相对路径如"./core/lerna/cli.js"—— VSCode 不保证执行时 cwd 是根目录
Ctrl+Click 跳转不到 my-utils 这类本地包
这是 TypeScript 符号解析断裂的典型表现。TS 默认只查 node_modules，但 Lerna 的本地包靠软链或 paths 映射暴露，TS 不知道去哪找源码。
- 根目录必须有统一的
tsconfig.base.json，每个包的tsconfig.json用"extends": "../tsconfig.base.json" -
tsconfig.base.json中需配置compilerOptions.paths，例如："my-utils": ["packages/my-utils/src"] - 改完后必须重启 TS 服务：快捷键
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux），输入 “TypeScript: Restart TS server” - 不要依赖 VSCode 自动推导——即使软链存在，没配
paths或没重启服务，跳转照样失败
tasks.json 绑定 lerna bootstrap 总是失败
硬写 "command": "lerna bootstrap" 会失败，因为它依赖正确的 cwd 和 node_modules 上下文，而 VSCode 默认从打开的文件夹启动任务，不一定在根目录。
- 在项目根目录建
.vscode/tasks.json，用type: "shell"+command: "npx lerna bootstrap" - 显式指定
options.cwd为"${workspaceFolder}"，确保命令在根目录执行 - 想只构建某个包，加
--scope=ui参数：npx lerna run build --scope=ui - 别在
dependsOn里手动写跨包依赖——Lerna 自己按lerna.json的commands配置或隐式拓扑决定顺序，VSCode 任务不参与该逻辑
最容易被忽略的是：所有配置都依赖一个前提——node 和 npx 在 VSCode 终端里必须能直接调用。如果 node -v 都报错，后面所有调试、跳转、任务都会连锁失效。先验证这个，再动其他。
