如何从Gitlab安装托管的.tgz格式npm包？

我有一个必须从Gitlab（而非npm注册表或其他注册表）安装的npm包。我创建了名为gitlab-release的发布分支，并在该分支中运行npm pack生成了.tgz文件。

当package.json中配置为：

"@team/ui-package": "git+https://gitlab-<corp>.net/<team>/<project>/ui-package#gitlab-release"

时，会将整个仓库拉取到node_modules中。

当配置为：

"@team/ui-package": "https://gitlab-<corp>.net/<team>/<project>/ui-package/-/archive/gitlab-release/project-ui-package-9.2.0.tar.tgz."

时，会出现以下错误：

npm ERR! code ENOPACKAGEJSON
npm ERR! package.json Non-registry package missing package.json: @team/ui-package@https://gitlab-<corp>.net/<team>/<project>/ui-package/-/archive/gitlab-release/project-ui-package-9.2.0.tar.tgz.
npm ERR! package.json npm can't find a package.json file in your current directory.

npm ERR! A complete log of this run can be found in:

单独访问该URL可正常下载.tgz文件，使用本地下载的.tgz文件安装则一切正常。请问如何对Gitlab仓库中托管的.tgz文件执行npm install？

方法一：修正URL格式并配置权限 #

• 移除URL末尾的多余点号：你提供的URL最后多了一个.，这会导致npm解析失败，正确的配置应为：

  "@team/ui-package": "https://gitlab-<corp>.net/<team>/<project>/ui-package/-/archive/gitlab-release/project-ui-package-9.2.0.tar.tgz"
  

• 处理私有仓库权限：如果Gitlab仓库是私有的，需要在URL中嵌入具有读取权限的访问令牌进行认证：

  "@team/ui-package": "https://<你的访问令牌>@gitlab-<corp>.net/<team>/<project>/ui-package/-/archive/gitlab-release/project-ui-package-9.2.0.tar.tgz"
  

方法二：使用Gitlab包注册表托管（更规范） #

1. 启用Gitlab项目的包注册表功能，将npm pack生成的.tgz文件上传到该注册表。
2. 在项目根目录创建或修改.npmrc文件，配置Gitlab包源：

   @team:registry=https://gitlab-<corp>.net/api/v4/packages/npm/
   //gitlab-<corp>.net/api/v4/packages/npm/:_authToken=<你的访问令牌>
   

3. 之后直接在package.json中指定版本即可安装：

   "@team/ui-package": "9.2.0"
   

方法三：Git子目录安装（避免拉取整个仓库） #

如果不想使用tgz文件，也可以通过Git URL指定子目录，只拉取目标包的内容：

"@team/ui-package": "git+https://gitlab-<corp>.net/<team>/<project>.git#gitlab-release:ui-package"

这里的:ui-package对应仓库中包所在的子目录路径，npm只会将该子目录的内容下载到node_modules。

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