corepack enable 失效的根本原因是 node.js 版本低于 16.9.0 或 corepack 未启用，导致 command not found；需确认 node -v ≥ 16.9.0 并执行 corepack enable，重启终端生效。

Corepack enable 为什么没生效

根本原因不是命令没输对，而是 Node.js 版本低于 16.9.0 或未启用 Corepack 功能。运行 corepack enable 报 command not found，说明 Corepack 尚未激活——它从 Node.js 16.9 开始默认集成，但需手动启用才能注册 yarn、pnpm 等命令到 shell。

常见现象包括：

• which yarn 返回空，或仍指向全局 npm 安装的 yarn
• yarn --version 输出与 corepack prepare yarn@x.x.x 指定版本不符
• VSCode 终端里 yarn 可用，但终端外（如系统 Terminal）不可用

解决办法：

• 确认 Node.js 版本：node -v，必须 ≥ 16.9.0；若为 14.x 或更旧，升级到 LTS（如 18.16.0 或 20.15.0）
• 执行 corepack enable 后，重启 VSCode 终端（不是仅关闭再打开标签页，要彻底重启终端进程）
• macOS/Linux 用户注意：若使用 nvm，每次 nvm use 后需重新 corepack enable，因为 Corepack 绑定的是当前 Node 实例

VSCode 终端里 yarn 版本不一致

VSCode 内置终端启动时继承的是 shell 的环境变量，但可能被 terminal.integrated.env.* 设置覆盖，或受 .zshrc/.bash_profile 中 PATH 修改影响。最典型表现是：yarn --version 在系统 Terminal 正确，但在 VSCode 里仍是旧版或报错。

排查步骤：

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• 在 VSCode 终端中运行 echo $PATH，对比系统 Terminal 输出，看是否缺失 ~/.local/share/corepack 或 Node bin 目录
• 检查 VSCode 设置中是否有 terminal.integrated.env.linux / env.osx 覆盖了 PATH
• 运行 corepack prepare yarn@1.22.19 --activate（指定 classic）或 yarn@4.0.0-rc.33（Berry），确保 prepare 后立即 --activate
• 不要依赖 npm install -g yarn，它会污染 PATH，且与 Corepack 冲突

package.json 中 "packageManager" 字段被忽略

"packageManager": "yarn@1.22.19" 是项目级版本声明，但 VSCode 本身不读取它来切换终端命令行为——它只影响 yarn 执行时的自动校验（比如你用 yarn install，Corepack 会检查是否匹配）。真正起作用的是 corepack prepare 注册的“可执行文件”。

关键事实：

• packageManager 字段只在运行 yarn 命令时触发校验，不改变 which yarn 结果
• VSCode 的 JS/TS 语言服务（如自动补全、跳转）完全不感知该字段，它只依赖 node 和 typescript 路径
• 若项目用了 Yarn Berry（PnP），需额外配置 .yarnrc.yml 并确保 yarn set version berry 已执行，否则 node_modules 解析会失败

调试时 Node.js 版本和 Corepack 不同步

VSCode 调试器（launch.json）默认调用系统 PATH 中的 node，它和 Corepack 管理的 yarn 是两套机制。如果你用 yarn run dev 启动服务，那实际运行的是 Corepack 激活的 Yarn + 当前 node；但直接 F5 调试单个 .js 文件时，VSCode 只认 node 路径，不管 Corepack。

这意味着：

• node -v 和 yarn --version 可以不同，且各自独立
• 调试器不会自动使用 nvm 当前版本，除非你在 launch.json 显式写死 "runtimeExecutable": "/path/to/node"
• 想让调试器也走 nvm 或 fnm 切换的版本，需配置 terminal.integrated.profiles.* 并设为默认 shell，或在 launch.json 中用 ${command:extension.node-debug.getRuntimePath}（需装对应插件）

最易被忽略的一点：VSCode 的「运行和调试」视图里看到的 Node 版本，和你在终端里 node -v 输出的，可能根本不是同一个二进制——尤其当你同时装了 Homebrew、nvm、NodeSource 多个来源时，which node 在终端和调试器里可能指向不同路径。