npm pack打包缺失index.d.ts 本地依赖缓存无法清除问题

一、index.d.ts 打包后缺失问题 #

• 先做基础校验：不要直接把包装到测试项目验证，手动解压npm pack生成的.tgz压缩包，直接看压缩包内部是否包含index.d.ts，先排除是安装环节缓存导致的文件缺失，而非打包环节的问题。
• 修复打包规则冲突：如果项目根目录没有.npmignore文件，npm会默认继承.gitignore的过滤规则。如果你的.gitignore里配置过*.d.ts规则（常见于RN项目忽略本地编译生成的类型文件），npm 6.x及更早版本存在规则优先级bug，即便你在package.json的files字段声明了要包含index.d.ts，实际打包时依然会把该文件过滤掉——这也是npx npm-packlist扫描显示文件存在、但实际tar包内缺失的核心原因，因为packlist扫描逻辑和旧版npm实际打包逻辑存在版本差异。
  修复方式二选一即可：
  1. 新建空的.npmignore文件放在项目根目录，阻断npm对.gitignore规则的继承
  2. 在files字段里写全所有要发布的文件，不要留模糊匹配："files": ["index.js", "index.d.ts", "README.md", "package.json"]
• 检查路径大小写匹配：本地macOS/Windows文件系统默认大小写不敏感，但npm打包、Linux生产环境是大小写敏感的，确认index.d.ts的实际文件名大小写，和types字段、files字段里配置的路径完全一致，不要出现文件叫Index.d.ts、配置写./index.d.ts的情况。
• 排查打包脚本干扰：执行npm pack --loglevel verbose看完整打包日志，检查有没有配置prepack/prepare生命周期脚本，在打包过程中误删了类型文件。

二、本地tar包缓存不更新问题 #

你之前清理npm缓存完全无效，核心原因是你用yarn install安装依赖，缓存逻辑完全独立于npm，且yarn存在多层高优先级缓存机制，按以下步骤彻底清理：

1. 清理yarn全局缓存
   先执行yarn cache dir查看yarn全局缓存的实际存储路径，可直接删除路径下所有和react-native-swisseph相关的缓存文件夹，或执行全量清理命令yarn cache clean。
2. 清理项目级高优先级缓存
   • 删除测试项目根目录下的node_modules文件夹、yarn.lock锁文件
   • 检查测试项目根目录下的.yarn/cache、.yarn/offline-mirror目录，这是Yarn Berry/PnP模式下的本地离线缓存存储位置，全局缓存清理不会触达这两个目录，直接删除目录内对应包的缓存文件即可
   • 检查用户根目录下的.yarnrc、.yarnrc.yml配置文件，看是否配置了yarn-offline-mirror离线镜像路径，该路径下存储的离线包优先级最高，哪怕你本地指定路径的tar包已经被删除，yarn依然会从离线镜像读取旧版本安装，直接删除该路径下对应包的tgz文件即可。
3. 免改版本号的本地调试安装方式
   不要把本地tar包的相对路径长期写在package.json里调试，安装本地包时直接执行带强制参数的命令，跳过所有缓存校验：
   yarn add file:/本地npm包源码的绝对路径 --force
   注意使用file:协议加绝对路径，相对路径在部分yarn版本中会被识别为固定版本强制走缓存，--force参数会要求yarn直接从指定路径读取最新文件重新打包安装，完全跳过缓存读取。
   若仍有缓存残留，可在路径后加无意义的临时锚点标记，不需要修改包版本号即可触发缓存更新：
   yarn add react-native-swisseph@file:/本地npm包源码的绝对路径#devtemp --force

验证方式：安装完成后直接打开node_modules/react-native-swisseph目录，核对目录内文件、package.json配置是否和本地最新源码完全一致，不要仅依赖安装成功的提示判断结果。

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