本地包@packrat/packages导入失败问题求助

1. 检查包的类型声明配置 #

• 进入node_modules/@packrat/packages目录，查看package.json中是否存在"types"字段，指向正确的类型声明文件（比如index.d.ts）。
• 如果包内没有类型声明文件，可在项目中添加自定义模块声明：
  在项目根目录创建typings/@packrat/packages/index.d.ts，写入：

  declare module '@packrat/packages' {
    // 根据包的实际导出内容补充类型，或先写export {}占位
    export const validators: any;
  }
  

  然后在tsconfig.json的include数组中加入"typings/**/*"。

2. 验证TSConfig的模块解析配置 #

• 打开项目的tsconfig.json，确认moduleResolution字段值为"node"或"nodenext"（适配Node.js模块解析规则）。
• 检查baseUrl和paths配置，确保没有错误映射@packrat/packages路径。如果是monorepo结构，需确认paths正确指向包的位置：

  {
    "baseUrl": ".",
    "paths": {
      "@packrat/packages": ["node_modules/@packrat/packages"]
    }
  }
  

3. 确认包的依赖来源配置 #

• 查看项目根目录的package.json，检查@packrat/packages的依赖项写法：
  • 如果是本地私有包（非公共registry），依赖应该是本地路径形式，比如"@packrat/packages": "file:../relative/path/to/package"，而非版本号（如^1.0.0）。
  • 若项目是monorepo，确认package.json中已配置workspaces字段，包含@packrat/packages所在目录：

    "workspaces": [
      "packages/*",
      "@packrat/packages"
    ]
    

• 避免使用yarn import命令，该命令用于将package-lock.json转换为yarn.lock，不适用于本地私有包场景，直接执行yarn install即可。

4. 清理Yarn缓存并重装依赖 #

• 执行命令清理缓存：

  yarn cache clean
  

• 删除node_modules和yarn.lock后，重新安装：

  rm -rf node_modules yarn.lock
  yarn install
  

5. 重启IDE的TypeScript服务 #

• 若使用VSCode，按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入TypeScript: Restart TS Server并执行，清除IDE缓存后重新检查导入。

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