npm EPERM：无法写入 `.npmrc` 的排查与解决

一、问题现象

在 Windows CMD 中执行：

npm config set allow-scripts="@waishnav/devspace,better-sqlite3,node-pty,@google/genai,protobufjs" --location=user

出现错误：

npm error code EPERM
npm error syscall open
npm error path C:\Users\Administrator\.npmrc
npm error errno -4048
npm error Error: EPERM: operation not permitted, open 'C:\Users\Administrator\.npmrc'

错误日志表明，npm 在尝试写入用户级配置文件：

C:\Users\Administrator\.npmrc

时被 Windows 操作系统拒绝。

---

二、问题定位

执行以下 PowerShell 命令检查 .npmrc：

powershell -NoProfile -Command "Get-Item 'C:\Users\Administrator\.npmrc' -Force | Format-List FullName,Attributes,PSIsContainer,Length"

得到结果：

FullName      : C:\Users\Administrator\.npmrc
Attributes    : ReadOnly, Archive
PSIsContainer : False
Length        : 113

结果分析

关键字段：

PSIsContainer : False

说明：

C:\Users\Administrator\.npmrc

是一个正常文件，而不是目录。

真正的问题在：

Attributes : ReadOnly, Archive
             ↑
           ReadOnly

.npmrc 被设置成了 只读文件。

npm 执行 npm config set 时需要修改并重新保存 .npmrc，由于文件处于只读状态，因此 Windows 返回：

EPERM: operation not permitted

---

三、解决方法

1. 移除 .npmrc 的只读属性

在 CMD 中执行：

attrib -R "C:\Users\Administrator\.npmrc"

其中：

-R

表示移除 ReadOnly 属性。

---

2. 检查只读属性是否已经移除

执行：

attrib "C:\Users\Administrator\.npmrc"

正常情况下，不应该再看到：

R

例如原来可能是：

A    R    C:\Users\Administrator\.npmrc

修改后应类似：

A         C:\Users\Administrator\.npmrc

---

四、重新执行 npm 配置

移除只读属性后，重新执行：

npm config set allow-scripts="@waishnav/devspace,better-sqlite3,node-pty,@google/genai,protobufjs" --location=user

如果不再出现 EPERM，说明问题已经解决。

---

五、验证 npm 配置

执行：

npm config get allow-scripts

检查配置是否成功。

也可以查看 .npmrc：

type "C:\Users\Administrator\.npmrc"

确认相关配置已经写入。

---

六、查看 npm 实际使用的用户配置文件

执行：

npm config get userconfig

正常情况下返回：

C:\Users\Administrator\.npmrc

这说明：

--location=user

对应的配置文件就是：

C:\Users\Administrator\.npmrc

---

七、如果仍然出现 EPERM

如果去掉只读属性之后仍然出现：

EPERM

可以继续检查 Windows ACL 权限。

查看权限

icacls "C:\Users\Administrator\.npmrc"

为 Administrator 授予完全控制权限

使用管理员 CMD：

icacls "C:\Users\Administrator\.npmrc" /grant Administrator:F

然后再次测试：

npm config set registry=https://registry.npmjs.org/ --location=user

---

八、必要时重新获取文件所有权

如果 ACL 本身异常，可以使用管理员 CMD：

takeown /F "C:\Users\Administrator\.npmrc"

然后：

icacls "C:\Users\Administrator\.npmrc" /grant Administrator:F

再执行：

attrib -R "C:\Users\Administrator\.npmrc"

---

九、不建议的处理方式

在已经确定只是 ReadOnly 属性导致问题的情况下，没有必要：

• 重装 Node.js
• 重装 npm
• 删除整个 npm cache
• 删除 Node.js 安装目录
• 删除 .npmrc
• 修改 npm 全局安装路径

因为从错误日志来看，Node.js 和 npm 本身已经能够正常运行。

问题仅发生在 npm 尝试保存：

C:\Users\Administrator\.npmrc

这一阶段。

---

十、最终推荐操作

对于本次问题，只需要执行：

attrib -R "C:\Users\Administrator\.npmrc"

然后：

npm config set allow-scripts="@waishnav/devspace,better-sqlite3,node-pty,@google/genai,protobufjs" --location=user

最后验证：

npm config get allow-scripts

---

十一、问题总结

根因

C:\Users\Administrator\.npmrc

具有：

ReadOnly

只读属性。

导致结果

npm 无法修改用户级 .npmrc，因此抛出：

EPERM
errno -4048
operation not permitted

最终解决

attrib -R "C:\Users\Administrator\.npmrc"

移除 .npmrc 的只读属性后，重新执行 npm config set 即可。

---

十二、排查流程速查

npm config set
      │
      ▼
EPERM / errno -4048
      │
      ▼
检查 C:\Users\Administrator\.npmrc
      │
      ├── PSIsContainer = True
      │        └── .npmrc 被误创建成目录
      │
      └── PSIsContainer = False
               │
               ▼
        检查 Attributes
               │
               ├── ReadOnly
               │      └── attrib -R .npmrc
               │
               └── 非只读
                      │
                      ▼
                 检查 ACL
                      │
                      └── icacls / takeown

结论

本次故障已经定位为 Windows 文件只读属性导致 npm 无法写入 .npmrc。

优先执行：

attrib -R "C:\Users\Administrator\.npmrc"

即可解决。