Windows11环境下npm无法本地安装包、更新配置文件如何解决？

问题表现 #

执行本地包安装命令时，包无法正常写入项目node_modules目录，同时不会更新package.json的依赖字段，也不会生成或更新package-lock.json文件。

标准复现步骤 #

• 执行mkdir testFolder新建空白测试目录
• 执行cd testFolder进入新建的目录
• 执行npm init，所有选项使用默认配置完成项目初始化
• 执行npm install dotenv触发安装操作，即可复现异常

已验证无效的排查操作 #

• 切换Windows系统开发者模式的开启/关闭状态后重试命令
• 借助NVM4W 1.1.9安装Node 16.15.1版本及对应NPM后重试安装
• 完全卸载NVM4W后，直接安装官方Node 18.4.0版本后重试

按优先级排序的修复步骤 #

每完成一步就重试npm install dotenv验证问题是否解决：

• 检查目录权限与系统防护拦截：右键测试文件夹打开「属性-安全」面板，确认当前登录的Windows账号对该目录拥有完全控制权限；临时关闭Windows Defender的「受控文件夹访问」功能，该功能默认开启时经常拦截终端程序的写入操作，是Windows 11下这类问题的高发诱因。
• 重置NPM本地配置：执行npm cache clean --force强制清空本地NPM缓存，再删除当前用户目录下的.npmrc文件（默认路径为C:\Users\你的登录用户名\.npmrc），排除错误镜像源、异常路径配置导致的行为异常。
• 校验NPM核心配置项：执行npm config list查看所有生效配置，重点检查两个配置：
  • 确认save配置值为true，若为false则执行npm config set save true修复，该配置为false时安装包不会写入package.json文件
  • 确认prefix、cache两个路径配置指向当前用户有读写权限的目录，不要指向系统级受保护路径
• 排除终端执行限制：不要使用第三方美化终端、PowerShell ISE运行命令，改用系统原生cmd（右键选择「以管理员身份运行」）进入测试目录重试；如果使用PowerShell，先执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser放开当前用户的脚本执行权限后再试。
• 排查路径兼容问题：确认测试目录的完整路径中没有中文、特殊符号、全角空格，部分老版本NPM对非ASCII路径存在兼容bug，可直接把测试目录放到磁盘根目录（比如C:\testFolder）下重试。

若以上操作全部无效，检查系统环境变量中的NODE_PATH、NPM_HOME字段，是否残留了之前卸载NVM、旧版本Node时留下的无效路径，残留路径优先级高于新安装版本的路径，会导致实际运行的NPM程序并非当前安装的版本。

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