使用npm link关联本地React/TS库后出现编译错误求助

以下是针对性的解决方案，逐一排查尝试：

• 统一React版本，避免双实例冲突
  本地库和主项目必须使用相同版本的React/ReactDOM。先在库的package.json中把React设为peer依赖，防止重复安装：

  "peerDependencies": {
    "react": "^18.0.0",
    "react-dom": "^18.0.0"
  }
  

  然后在库的目录下执行npm link ../主项目路径/node_modules/react，强制让库复用主项目的React实例，避免加载两份React导致的类型不兼容。

• 修正库的TypeScript编译配置
  确保库的tsconfig.json关键配置正确：

  • jsx字段设为react-jsx（适配React 17+）或react
  • declaration设为true，保证生成完整的类型声明文件
  • outDir指向dist目录，同时在库的package.json里指定types字段路径，比如"types": "./dist/index.d.ts"
    重新构建库后再执行npm link。

• 调整主项目TS配置，识别库源码类型
  在主项目的tsconfig.json中，把本地库的源码路径添加到paths配置，让TypeScript正确解析库的类型：

  "compilerOptions": {
    "baseUrl": "./src",
    "paths": {
      "@myScope/myLibrary": ["../本地库路径/src"]
    }
  }
  

• 清理缓存后重新关联
  缓存可能导致旧配置残留，执行以下步骤重置：

  1. 本地库目录：npm run build && npm unlink && npm link
  2. 主项目目录：npm unlink @myScope/myLibrary && npm link @myScope/myLibrary
  3. 重启主项目开发服务器，同时清理IDE的TypeScript缓存（比如重启VS Code）

如果上述方法无效，可以尝试用npm pack生成库的tar包，在主项目中执行npm install ../本地库路径/xxx.tgz安装，这种方式比npm link更稳定，也能通过修改库源码后重新pack安装来实现调试需求。

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