vscode 中 npm link 后 typescript 服务无法识别模块，根本原因是其默认不索引软链接且未配置 paths 或 typeroots；需在 tsconfig.json 中添加 paths 指向源码或 typeroots 指向类型文件，并手动重启 ts server。
npm link 在 VSCode 里不生效，不是模块没链上，而是 TypeScript/JavaScript 语言服务压根没看到它——智能提示、跳转、类型检查全挂，但 node 运行时照常能跑。
为什么 npm link 后 VSCode 找不到模块？
根本原因不是链接失败，而是 VSCode 的 TS/JS 语言服务（即 TypeScript Server）默认只扫描 node_modules 下的已安装包，对软链接（npm link 创建的 symlink）不主动索引，尤其当被 link 的包没有生成或暴露 .d.ts 类型文件时，类型系统就彻底失联。
- 执行
npm link和npm link your-package成功，node_modules/your-package确实是 symlink，终端里require('your-package')能跑通 - 但 VSCode 编辑器里 import 报红、Ctrl+点击跳转失败、无自动补全
-
npm ls your-package显示已安装，说明依赖树没问题 - 重启 VSCode 或重载窗口无效 —— 因为语言服务缓存的是“已解析的模块路径”，不是文件系统实时状态
tsconfig.json 必须加 typeRoots 或 paths
这是最直接有效的解法。VSCode 的 TS 服务靠 tsconfig.json 的 compilerOptions 决定从哪读类型定义。link 的包若自带 types 字段或输出了 index.d.ts，就得显式告诉 TS 去哪找。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 在 consuming 项目（即你
npm link your-package的那个项目）根目录的tsconfig.json中添加：
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"your-package": ["../your-package/src/index"],
"your-package/*": ["../your-package/src/*"]
}
}
}
.d.ts，但你本地有源码，就用 paths 指向其 src 目录（注意路径是相对于 baseUrl）"types": "dist/index.d.ts"），且你确认该路径存在，改用 typeRoots："typeRoots": ["node_modules/@types", "../your-package/dist"]
npm link 失败报 EPERM？别硬刚权限
Windows 上常见 Error: EPERM: operation not permitted，本质是 npm 尝试在全局 node_modules 创建 symlink 时被系统拦截，和 VSCode 无关，但会阻断整个流程。
- 不要删
npmrc文件 —— 多数无效 - 不要长期以管理员身份运行 VSCode —— 安全风险高，且 link 后仍可能无法被 TS 识别
- 推荐做法：在终端里先用
npm link（非 VSCode 内置终端），再用npm link your-package到目标项目；确保两处都在同一用户上下文下执行 - macOS/Linux 用户注意：如果用了
nvm，确保npm link时用的是同一个 Node 版本（nvm current与which node一致）
重启不是万能的，但 TS Server 重启是刚需
VSCode 界面重启、重载窗口、甚至关机再开，都不等于 TypeScript 语言服务重启。只要 tsconfig.json 改了或 link 路径变了，就必须手动刷新 TS Server。
- 快捷键：
Cmd/Ctrl + Shift + P→ “TypeScript: Restart TS server” - 验证是否生效：打开一个 import 语句，看有没有红色波浪线；把光标停在模块名上，看底部状态栏是否显示类型信息
- 如果仍不行，检查被 link 包的
package.json是否含"types"或"typings"字段，且对应文件真实存在 - 最后手段：删掉 consuming 项目的
node_modules/your-package，重新npm link your-package，再重启 TS Server
真正卡住人的从来不是 link 命令本身，而是类型系统和编辑器之间的那层“信任”。paths 配置和 TS Server 重启，才是让 VSCode “看见” link 模块的关键动作。漏掉任意一个，智能提示就永远灰着。
