Npm install无法拉取私有GitLab包全部文件，仅包含index.tsx

以下是针对性的排查和解决步骤：

• 检查package.json的files字段
  npm发布包时，会依据files字段确定要包含的文件范围。如果该字段仅列出index.tsx，其他文件及source目录会被自动排除。修改package.json，将需要的文件/目录加入files数组：

  {
    "files": [
      "index.tsx",
      "source/",
      "utils.ts",
      "components/"
    ]
  }
  

  同时确认是否存在.npmignore文件，它的规则会覆盖files字段配置。如果.npmignore中写了source/或其他需要保留的文件，直接删除对应规则，或者删掉.npmignore文件。

• 排查GitLab CI/CD发布脚本
  如果是通过CI自动发布包，检查构建脚本是否存在仅复制单个文件的操作。比如避免类似cp index.tsx dist/ && cd dist && npm publish的命令——这种操作会导致仅index.tsx被打包发布。正确做法是直接在项目根目录执行npm publish，或者确保构建后的目标目录（如dist）包含所有需要的文件后再执行发布。

• 检查.gitignore的影响
  若未配置files字段，npm会默认排除.gitignore中标记的文件。如果source目录在.gitignore内，且未在files里明确指定，就会被排除。解决方式：要么将source从.gitignore中移除，要么在files数组里添加source/。

• 重新发布新版本
  修改配置后，必须更新包的版本号（执行npm version patch/minor/major），再重新发布到GitLab npm仓库。旧版本的包已缺失文件，安装时会默认拉取旧版本，只有新版本才会包含完整文件。

• 本地验证打包内容
  发布前执行npm pack命令，生成.tgz压缩包后解压，检查包内是否包含所有需要的文件。如果仍有缺失，继续调整配置，直到打包内容符合预期再发布。

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