pnpm命令在vscode终端报“无法识别”主因是终端未加载shell初始化文件导致path缺失pnpm路径，或powershell执行策略限制阻止pnpm.ps1运行，需先确认全局安装、补全环境变量、修改执行策略（remotesigned），并确保vscode以code .启动继承完整path。
pnpm命令在VSCode终端报“无法识别”
不是VSCode本身不认pnpm，而是终端没找到可执行文件——常见于Node版本切换后、PowerShell策略限制、或PATH未包含npm全局路径。
先确认基础状态：node -v 和 npm -v 能正常输出，说明Node和npm已安装；但pnpm -v 报错，就进入排查链：
- 运行
where pnpm（Windows）或which pnpm（macOS/Linux），看是否返回路径；无输出说明全局未安装或PATH缺失 - 执行
npm config get prefix，得到类似C:\Users\xxx\AppData\Roaming\npm的路径，把这个路径手动加进系统环境变量PATH - 如果用nvm切换过Node版本，
pnpm实际只装在旧版本目录下（如C:\Users\xxx\.nvm\v20.10.0\pnpm.cmd），新版本不会自动继承——必须重新执行npm install -g pnpm
PowerShell执行策略阻止pnpm.ps1运行
错误信息里带 无法加载文件 ... pnpm.ps1，因为在此系统上禁止运行脚本，就是PowerShell默认策略在拦你。
这不是VSCode的问题，是Windows PowerShell的安全机制。解决方式很直接：
- 在VSCode终端里运行
Get-ExecutionPolicy，若返回Restricted，说明被禁了 - 执行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（加-Scope CurrentUser避免弹管理员窗口） - 再跑一次
Get-ExecutionPolicy，确认输出是RemoteSigned - 注意：改完不用重启VSCode，但要新开一个终端标签页才生效
VSCode语言服务不识别pnpm-linked模块
项目里用了 pnpm link 或 pnpm add -D file:../my-utils，但VSCode跳转定义失败、import报红，说明TypeScript语言服务没穿透软链接。
关键不在pnpm，而在tsconfig/jsconfig的配置和语言服务器行为：
- 确保项目根目录有
tsconfig.json（TS）或jsconfig.json（JS），且含"moduleResolution": "node" -
"include"字段必须显式列出软链目标路径，比如"linked-utils/**/*"，否则语言服务默认跳过符号链接目录 - 执行
Developer: Restart Language Server（Cmd/Ctrl+Shift+P），强制重载索引——npm link不会触发自动重载 - 检查软链目标是否有
package.json和types字段（或index.d.ts），否则即使路径对，也会退化为any类型
跨卷或iCloud symlink在macOS上失效
软链指向 /Volumes/ExternalDisk/my-lib 或 ~/Library/Mobile Documents/com~apple~CloudDocs/my-lib 时，VSCode常报“找不到模块”，但 node -e "require.resolve('my-lib')" 却能成功——这是macOS系统级限制。
APFS加密卷和iCloud Drive默认禁止跟随外部挂载点的符号链接，Node.js运行时能绕过，但VSCode语言服务不能：
- 不要把软链目标放在
/Volumes或 iCloud 同步目录下，挪到用户主目录内（如~/dev/my-lib）最稳妥 - 若必须跨卷，用硬链接替代（
ln my-lib ../project/node_modules/my-lib），但注意硬链接不支持目录 - 验证是否真卡在这里：在终端cd进项目，执行
ls -la node_modules/my-lib，看箭头指向是否异常（比如显示@但路径不可达）
软链接失效真正麻烦的地方，从来不是“它不存在”，而是“它存在，但不同层（Node运行时 / TypeScript语言服务 / macOS文件系统）各自认或不认”。修的时候得一层一层对齐，漏掉任意一层，表面看起来都像“没生效”。
