You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

终端执行npm安装框架命令提示--global参数弃用警告如何解决

问题现象

执行npm相关的框架安装、项目创建命令时,终端输出首行固定返回如下警告信息:

npm WARN config global --global, --local are deprecated. Use --location=global instead.

可触发该警告的典型执行命令包括:

npm install @vue/cli
npx create-react-app my-app
问题原因

该提示属于版本兼容类警告,并非运行错误,不会阻塞命令正常执行,触发原因如下:
当本地安装的npm版本处于v8.11.0 ~ v8.19.x区间时,npm官方已将旧的全局参数--global/-g、本地参数--local标记为废弃,要求统一使用--location=global的新参数规范,但同版本Node.js内置的npm、npx启动脚本仍在沿用旧参数写法,命令启动时就会抛出该警告。

解决方法

可根据自身需求选择对应方案处理:

  • 升级npm至最新稳定版(推荐方案)
    升级后官方脚本会自动适配新参数规范,警告直接消除:
    • Windows系统:以管理员身份打开终端,依次执行以下命令
      npm install -g npm-windows-upgrade
      npm-windows-upgrade
      
      执行后按照提示选择最新稳定版npm完成安装即可。
    • Mac/Linux系统:在终端执行以下命令
      sudo npm install -g npm@latest
      
    升级完成后重启终端,再执行原命令就不会出现该警告。
  • 手动修改启动脚本(不想升级npm时使用)
    找到本地Node.js安装根目录,定位到目录下的npm、npm.cmd、npx、npx.cmd四个文件,用文本编辑器打开,将文件内所有的--global、--local参数替换为--location=global,保存后重启终端即可生效。
  • 忽略警告(无操作方案)
    该提示仅为参数废弃提醒,不会对安装结果、项目运行造成任何影响,如果不介意终端多一行输出,完全可以不做任何处理,后续升级Node.js版本到自带适配新参数的npm版本时,警告会自动消失。

内容的提问来源于stack exchange,提问作者Mikael Tenshio

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.29 16:01:07