四个本地npm包中仅package-1的npm link失效问题排查求助

1. 检查@CT/package-1的package.json细节 #

• 确认name字段与主项目依赖声明完全一致，包括大小写、scope符号（@和斜杠），npm对scope包名称大小写敏感，细微差异会触发远程仓库查找
• 排查是否存在publishConfig字段，若配置了指向github npm仓库的registry，会强制npm优先远程拉取，忽略本地link：

  "publishConfig": {
    "registry": "https://npm.pkg.github.com/"
  }
  

• 验证version字段格式是否合法，异常版本号会导致npm放弃本地link，尝试远程匹配

2. 核对主项目依赖配置 #

• 检查主项目package.json中@CT/package-1的依赖声明格式，是否与其他三个包一致：若写成带版本范围的形式（如^1.0.0），且远程仓库无对应版本，会触发404
• 确认是否为@CT/package-1单独配置了resolutions字段，强制指向远程仓库（node13版本暂不支持overrides，但需排查resolutions）

3. 排查.npmrc配置冲突 #

• 对比全局、主项目本地、@CT/package-1目录下的.npmrc文件，检查是否存在针对@CT scope的特殊registry配置（如@CT:registry=https://npm.pkg.github.com/），且仅对package-1生效
• 执行npm config list查看当前生效配置，确认link配置为true（若设为false会忽略本地link）

4. 重新校验npm link关联状态 #

• 先执行npm unlink @CT/package-1解除关联，再在@CT/package-1目录重新执行sudo npm link，最后在主项目执行npm link @CT/package-1，确保链路正常
• 查看主项目node_modules/@CT/package-1的符号链接指向：Linux/macOS用ls -l node_modules/@CT/package-1，Windows用dir /AL node_modules\@CT\package-1，确认链接指向本地包目录
• 检查本地包目录权限，sudo创建的link可能导致主项目用户无访问权限，npm会 fallback 到远程查找

5. 清理缓存文件 #

• 执行npm cache clean --force清理npm缓存，避免旧配置干扰
• 删除主项目的package-lock.json后重新执行npm i，lock文件可能缓存了错误的registry地址

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