vscode配置yarn成功需终端能执行yarn --version、任务默认调用yarn、ts server正确解析模块路径三者同时满足;任一缺失均导致降级回npm或报错。

VSCode 本身不“配置” Yarn,它只调用你系统里已安装的 yarn —— 所有失败都源于终端没找到命令、任务写死了 npm、或 TS Server 没认出 Yarn 的模块结构。三个环节必须同时对齐,少一个就降级或报错。
VSCode 终端里 yarn --version 报 command not found
这不是 VSCode 设置错了,是它的集成终端压根没加载你的 shell 环境变量(比如 ~/.zshrc 或 $PROFILE),所以找不到 yarn 路径。
- 先在系统终端(不是 VSCode 里)运行
which yarn,记下输出,例如/opt/homebrew/bin/yarn或/Users/xxx/.yarn/bin/yarn - 打开 VSCode 内置终端,再跑一遍
which yarn—— 如果没输出,说明 PATH 没传进来 - macOS 用户别从 Dock 启动 VSCode,改用命令行执行
code .;Windows 用户若用 Git Bash,需在设置里把terminal.integrated.defaultProfile.windows设为Git Bash - 兜底方案:在 VSCode 设置中搜
terminal.integrated.env,手动补 PATH,例如:"terminal.integrated.env.osx": {"PATH": "/opt/homebrew/bin:/usr/local/bin:${env:PATH}"}
Run Task 默认仍执行 npm install 而不是 yarn install
VSCode 不会自动猜你用了 Yarn —— 它只认 tasks.json 里写的字面量,或靠 package.json 的 packageManager 字段自动生成任务。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1),免gas,支持macOS/Linux/Windows。触发词:/r
- 确保项目根目录的
package.json包含"packageManager": "yarn@4.0.0"(Yarn 3.1+ 支持) - 删掉残留的
.vscode/tasks.json,避免硬编码了"command": "npm" - 按
Cmd/Ctrl+Shift+P→ 输入Tasks: Configure Task→ 选Create tasks from package.json - 生成的任务里应出现
"command": "yarn"和"args": ["install"],而不是"npm install"
TypeScript 报 “无法找到模块”,但项目能正常运行
这是 TS Server 没正确识别 Yarn 的模块链接方式,尤其在启用 PnP(.pnp.cjs)后极常见 —— 和终端、任务都无关,纯路径解析问题。
- 必须用 VSCode 打开整个 workspace 根目录(即含
yarn.lock或.yarnrc.yml的文件夹),不能只开子包目录 - 看状态栏右下角:要是显示
TypeScript SDK: Project version,说明作用域错了,得改成Workspace version - 确认已运行
yarn set version stable生成.pnp.cjs,且.yarnrc.yml中有nodeLinker: pnp - 改完
tsconfig.json或切换包管理器后,务必手动执行Cmd/Ctrl+Shift+P→TypeScript: Restart TS server
最容易被忽略的是:终端 PATH、tasks 自动生成逻辑、TS Server 的 workspace 识别这三处必须全部对齐。比如你手动补了 PATH 让终端能跑 yarn,但没设 packageManager 字段,Run Task 还是走 npm;或者开了 workspace 但没重启 TS Server,import 依然标红。每个环节都得单独验证,不能假设“一个好了,其他也好了”。










