如何将本地开发的npm包动态链接到其他项目并解决WebStorm缓存问题

直接在主项目package.json中将基础设施包的版本字段替换为本地项目的绝对/相对路径：

{
  "dependencies": {
    "your-infra-package": "file:../your-local-infra-project-path"
  }
}

执行npm install完成安装，该方式会直接在node_modules中创建指向本地目录的软链，兼容性优于npm link。
如果基础设施包需要编译后才能使用，在包目录下执行tsc --watch（或对应构建工具的监听命令，如rollup -w），修改代码后会自动输出最新编译产物，主项目运行时可直接读取生效。

TS服务默认仅扫描node_modules内的类型声明一次，不会监听软链包的文件变动，可在主项目tsconfig.json中添加路径映射，让TS直接读取基础设施包的源码做类型校验：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "your-infra-package": ["../your-local-infra-project-path/src"],
      "your-infra-package/*": ["../your-local-infra-project-path/src/*"]
    }
  }
}

配置完成后修改基础设施包的TS类型、接口、函数签名等内容时，TS服务会自动检测变动，无需重启IDE即可获得正确的类型提示与校验结果。

该功能可满足多项目同时开发时的代码关联需求，操作步骤如下：

• 打开主项目后，点击菜单栏 File -> Attach，选择本地基础设施包项目，两个项目会在同一工作区展示
• 打开 Settings -> Languages & Frameworks -> JavaScript -> Libraries
• 点击Add按钮，将基础设施包的src目录添加为自定义库，作用域选择当前主项目，类型选择TypeScript community stubs
  配置完成后WebStorm的索引会同时覆盖两个项目的代码，不会仅依赖node_modules内的缓存文件。

无需清空整个IDE缓存，遇到临时类型报错时可按以下步骤操作，耗时不超过10秒：

• 双击Shift打开全局搜索，输入Restart TypeScript Service后回车执行，重启TS服务
• 若仍未恢复，右键点击主项目的node_modules文件夹，依次选择Mark Directory as -> Not Excluded，再重新选择Mark Directory as -> Excluded，触发IDE重新索引依赖

内容的提问来源于stack exchange，提问作者Yoav Moran