npm install安装GitHub私有NPM包时返回401 Unauthorized如何解决

1. 确认PAT权限配置正确 #

• 如果你使用的是经典PAT，必须勾选read:packages权限；如果拉取的是私有组织下的包，还需要额外勾选read:org权限
• 如果你使用的是细粒度PAT，需要在权限配置中为对应组织/个人账号的Packages权限设置为Read-only，同时确保该PAT已获得对应资源的访问授权
  注意：PAT生成后仅在生成页面可查看完整值，遗忘后需重新生成新的PAT

2. 检查.npmrc配置完整性 #

• 确认配置中的@org-name和依赖包的作用域完全一致，大小写严格匹配：如果拉取的是个人账号下的包，这里要替换为你的GitHub用户名，而非组织名
• 补充always-auth配置，部分场景下GitHub Packages要求强制校验身份，修改后的完整配置如下：

//npm.pkg.github.com/:_authToken=ghp_MY_TOKEN
//npm.pkg.github.com/:always-auth=true
@org-name:registry=https://npm.pkg.github.com/

• 执行npm config list查看当前生效的npm配置，确认项目级的.npmrc配置没有被全局配置覆盖

3. 清理Windows本地冲突凭证 #

Windows系统的凭据管理器会缓存GitHub Packages的身份信息，优先级高于本地.npmrc配置，如果存在旧的过期凭证会直接导致鉴权失败：

1. 打开「控制面板」->「用户账户」->「凭据管理器」->「Windows 凭据」
2. 查找所有包含npm.pkg.github.com的凭证条目，全部删除后重新执行npm install即可

4. 手动验证登录有效性 #

可以通过主动登录的方式排查配置问题，执行以下命令：
npm login --registry=https://npm.pkg.github.com --scope=@org-name
按提示输入对应信息：

• 用户名：你的GitHub用户名
• 密码：你的PAT值
• 邮箱：GitHub账号绑定的公开邮箱
  登录成功后再执行安装操作即可。

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