npm警告：全局选项 --global 和 --local 已弃用

问题描述

当使用 npm install -g 命令安装全局包时，可能出现以下警告信息：

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

这个警告表示您正在使用的 npm 版本中，--global 和 --local 选项已被标记为弃用，建议使用新的 --location=global 选项替代。

根本原因

这个警告是由于 npm 8.11.x 版本中的一个已知问题引起的，该版本在 Windows 系统上与新的命令行参数语法不兼容。虽然这是一个警告而非错误（命令仍然可以执行），但建议修复以避免未来可能的问题。

解决方案

方法一：更新 npm 到最新版本（推荐）

最简单的解决方法是更新 npm 到最新版本：

npm install --global npm@latest

如果上述命令因权限问题无法执行，可以尝试：

Windows

# 以管理员身份运行 PowerShell 或命令提示符
npm install --global npm@latest

macOS/Linux

# 使用 sudo 提升权限
sudo npm install --global npm@latest

方法二：使用正确的语法

直接使用新的 --location=global 参数替代 -g 或 --global：

npm install --location=global create-react-app

方法三：使用 npx（针对 Create React App）

对于 Create React App，官方推荐使用 npx 而不是全局安装：

npx create-react-app my-app

这种方法不需要全局安装任何包，避免了权限问题和版本冲突。

方法四：手动编辑 npm 配置文件（Windows 专用）

如果上述方法无效，可以手动修改 npm 的配置文件：

1. 导航到 Node.js 安装目录（通常是 C:\Program Files\nodejs）

2. 使用文本编辑器（如 VS Code）以管理员身份打开以下四个文件：

   • npm
   • npm.cmd
   • npx
   • npx.cmd

3. 在所有文件中将 prefix -g 替换为 prefix --location=global

4. 保存文件并重新打开命令提示符

注意

手动编辑系统文件存在风险，建议先备份原始文件。此方法只适用于 Windows 系统。

方法五：重新安装 Node.js

如果问题持续存在，可以考虑卸载并重新安装最新版本的 Node.js：

1. 从控制面板卸载当前的 Node.js
2. 访问 Node.js 官网下载最新版本
3. 运行安装程序并按照提示完成安装

额外建议

1. 检查安全漏洞：运行 npm audit 检查并修复包中的安全漏洞
2. 定期更新：保持 Node.js 和 npm 为最新版本以避免类似问题
3. 权限管理：在 Windows 上，确保以管理员身份运行命令提示符进行全局安装

总结

npm 的弃用警告虽然不影响当前操作，但建议采取以下措施之一解决问题：

1. 更新 npm 到最新版本（最简单安全的方法）
2. 使用新的 --location=global 参数
3. 对于 Create React App，使用 npx 而非全局安装

保持开发环境的更新是避免此类问题的最佳实践。