Windows下全局安装workbox-cli成功后执行workbox wizard提示命令不存在如何解决

问题原因排查 #

• fsevents相关警告属于正常提示：fsevents是仅适配macOS系统的可选依赖，npm在Windows环境下会自动跳过安装，日志中的SKIPPING OPTIONAL DEPENDENCY已明确标注该依赖被跳过，完全不影响workbox-cli在Windows下的运行，你并未安装Mac版本的workbox。
• 命令无法识别的核心原因：从安装日志可见，workbox的可执行文件已经被安装到c:\npm目录下，无法识别命令是因为Windows系统的环境变量PATH中没有添加c:\npm路径，系统无法找到对应的可执行文件。

解决方案 #

临时验证方法 #

直接输入完整路径执行命令，验证workbox是否正常安装：
c:\npm\workbox wizard
如果能正常启动配置向导，说明workbox安装完全正常，仅需修复环境变量配置即可。

永久修复环境变量 #

1. 按下Win + R组合键，输入sysdm.cpl后回车，打开系统属性面板
2. 切换到「高级」选项卡，点击底部的「环境变量」按钮
3. 在用户变量或系统变量列表中找到Path变量，双击进入编辑页面
4. 点击「新建」，添加c:\npm路径，依次点击所有弹窗的「确定」按钮保存配置
5. 关闭当前所有cmd窗口，重新打开后执行workbox wizard即可正常识别命令。

免全局安装方案 #

如果不想修改系统环境变量，也可以在项目中局部安装使用：

# 进入你的项目目录，安装workbox-cli为开发依赖
npm install workbox-cli --save-dev
# 使用npx调用workbox命令
npx workbox wizard

内容的提问来源于stack exchange，提问作者Martin Turberville-Smith