npm WARN config `--global`/`--local`警告：成因及初始安装解决方法咨询

警告原因 #

• npm v7及以上版本已经废弃了--global和--local这两个配置参数，官方改用--location=global和--location=local来替代。如果你的npm配置文件（比如全局或项目根目录下的.npmrc）里还保留着旧的prefix=--global这类带废弃参数的配置项，执行任何npm命令都会触发这个警告。
• 另外，一些旧版本的第三方工具、自动安装脚本生成的.npmrc文件，可能还在沿用这些已被淘汰的参数，这也是触发警告的常见场景。

初始安装阶段解决方法 #

1. 安装时直接配置正确参数 #

手动安装npm或Node.js时，设置全局安装路径就用新参数格式，从根源避免生成错误配置：

# Windows系统示例
npm config set prefix "C:\Users\YourName\AppData\Roaming\npm" --location=global

# 类Unix系统（Linux/macOS）示例
npm config set prefix "/usr/local/npm-global" --location=global

2. 安装后立即检查并修正配置 #

用包管理器（brew、apt等）安装Node.js后，先检查现有配置：

npm config list

如果输出里有带--global/--local的配置项，直接删除后重新设置：

# 删除错误的全局prefix配置
npm config delete prefix --location=global
# 重新设置正确路径
npm config set prefix "/your/preferred/global/path" --location=global

3. 更新自定义安装脚本 #

如果用自定义脚本安装Node.js/npm，把脚本里旧的配置命令替换成新格式：

• 旧写法：npm config set prefix ~/.npm-global --global
• 新写法：npm config set prefix ~/.npm-global --location=global

4. 项目初始化前确认配置 #

执行npm init初始化项目前，先验证全局和本地配置的正确性：

# 查看全局prefix配置
npm config get prefix --location=global
# 查看本地prefix配置（当前项目目录）
npm config get prefix --location=local

只要返回的是正常路径，没有包含--global/--local字符串，就可以放心初始化项目，不会在本地.npmrc里生成错误配置。

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