将npm包从Azure DevOps迁移至GitHub的包名配置问题咨询

一、能否在GitHub上发布不带组织名的npm包？ #

分两种场景：

• 公共包：如果目标包名（比如ABC）在npm公共注册表中未被占用，且你以公司组织XYZ的账号发布，是可以发布不带@XYZ/前缀的非作用域（non-scoped）公共包的。发布时需在命令中指定--access public参数，确保包被设为公开可见。
• 私有包：GitHub Packages要求私有npm包必须是作用域（scoped）包，也就是必须带@XYZ/前缀，无法发布不带组织名的私有包。

二、能否配置npm在npm install时优先检查@XYZ下的包？ #

可以通过两种方式实现需求，甚至无需修改项目代码中的引入路径：

1. 定向指定作用域包的源 #

在项目根目录的.npmrc文件中添加以下配置（仅对当前项目生效）：

@XYZ:registry=https://npm.pkg.github.com/

如果要让配置对所有项目生效，可执行全局配置命令：

npm config set @XYZ:registry=https://npm.pkg.github.com/

这样npm在安装@XYZ/开头的包时，会优先从GitHub Packages拉取，而非默认的npm公共源。

2. 自动映射旧包名到新的作用域包 #

如果不想修改代码里的import ABC from 'ABC'这类引入语句，可通过两种方式实现自动替换：

• 别名安装：执行安装命令时直接指定别名，后续npm install会自动拉取新包：

npm install ABC@npm:@XYZ/ABC

此时项目的package.json中会显示"ABC": "npm:@XYZ/ABC"，代码无需改动。

• overrides全局替换：在项目的package.json中添加overrides字段，强制所有依赖ABC的地方替换为@XYZ/ABC，适合项目中有多层依赖引用ABC的场景：

"overrides": {
  "ABC": "@XYZ/ABC"
}

内容的提问来源于stack exchange，提问作者Triple.B