根本原因是node 16+默认启用corepack，旧项目依赖全局yarn，而vscode终端优先加载corepack管理的yarn 3+，与项目engines或yarn.lock格式不兼容，导致命令识别失败或install报错。
为什么升级Node后VSCode里yarn命令突然报错
根本原因是Node 16+默认启用corepack，而旧项目仍依赖全局安装的yarn。VSCode终端启动时会优先加载corepack管理的yarn（通常是Yarn 3+），但老项目package.json里的"engines"或yarn.lock格式可能不兼容，导致yarn install直接失败，甚至yarn --version都提示CommandNotFoundException。
检查当前yarn来源是corepack还是npm全局安装
在VSCode集成终端中运行：
yarn --version which yarn corepack list
如果which yarn返回类似/Users/xxx/.corepack/bin/yarn或C:\Users\xxx\AppData\Local\Volta\bin\yarn，说明当前走的是corepack或volta；若返回/usr/local/bin/yarn或C:\Users\xxx\AppData\Roaming\npm\yarn，则是npm全局安装路径。两者共存时，VSCode终端可能因PATH顺序或shell初始化脚本冲突，只识别其中一个。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- Windows用户常见现象：
yarn在cmd能用，但在VSCode PowerShell终端报“无法将‘yarn’项识别为cmdlet”——这是PowerShell执行策略阻止了全局npm bin下的脚本 - macOS/Linux用户注意：
corepack启用后，npm install -g yarn安装的版本会被忽略，除非显式禁用corepack
快速恢复旧项目yarn可用性的三步操作
不建议直接卸载corepack或降级Node，而是让项目明确声明所需yarn版本并隔离运行环境：
- 进入项目根目录，运行
corepack use yarn@1.22.22（填你项目实际需要的1.x版本号）——这会在项目级生成.corepack.yaml，VSCode终端下次打开自动加载对应版本 - 删除项目中的
yarn.lock（如有），然后运行yarn set version berry（仅当需升级到Yarn 3+）；否则保持yarn install即可 - 若仍报权限错误（如PowerShell提示“因为此系统上禁止运行脚本”），在VSCode终端执行
set-executionpolicy remotesigned -scope currentuser，无需管理员权限
VSCode终端配置要避开的坑
VSCode默认终端Profile可能缓存旧shell环境变量，尤其在Node版本切换后：
- 不要只改
terminal.integrated.defaultProfile.windows，还要检查terminal.integrated.profiles.windows里是否硬编码了旧node路径 - 重启VSCode前，先关闭所有终端页签，否则旧shell进程可能继续读取过期的
$PATH - 如果用了
nvm，确保~/.nvm/nvm.sh或%USERPROFILE%\AppData\Roaming\nvm\settings.txt已正确配置，并在VSCode设置中启用terminal.integrated.env.os注入nvm环境
真正起作用的是终端启动那一刻加载的shell初始化文件，不是VSCode设置里写的某一行PATH。每次Node环境变动，都要验证终端里echo $PATH（macOS/Linux）或echo %PATH%（Windows）是否包含当前node版本对应的yarn bin路径。
