Windows下安装Zoho Catalyst CLI后仍遇“catalyst未识别”错误求助

问题重现 #

通过npm install -g zcatalyst-cli全局安装Zoho Catalyst CLI后，执行catalyst -v或catalyst --version时出现错误：

catalyst: The term 'catalyst' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.

At line:1 char:1 + catalyst --version

• CategoryInfo: ObjectNotFound: (catalyst :String) [], CommandNotFoundException
• FullyQualifiedErrorId: CommandNotFoundException

解决方案 #

这个问题核心是npm全局包的可执行文件路径未加入Windows系统环境变量，导致终端无法定位catalyst命令。按以下步骤修复：

1. 定位npm全局可执行文件路径 #

打开命令提示符（CMD）或PowerShell，执行命令获取npm全局前缀路径：

npm config get prefix

通常返回路径为：C:\Users\<你的用户名>\AppData\Roaming\npm（替换<你的用户名>为实际Windows用户名）

2. 将路径添加到系统环境变量 #

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在「系统变量」区域找到Path变量，点击「编辑」
• 点击「新建」，粘贴刚才获取的npm全局前缀路径，依次点击「确定」保存所有设置

3. 重启终端并验证 #

关闭所有已打开的CMD/PowerShell窗口，重新打开后执行：

catalyst -v

此时应能正常显示CLI版本号。

备选排查步骤 #

如果添加环境变量后仍无效：

• 执行npm uninstall -g zcatalyst-cli彻底卸载CLI，再重新安装：npm install -g zcatalyst-cli
• 检查npm config get prefix返回的路径是否正确，若异常可手动设置：

  npm config set prefix "C:\Users\<你的用户名>\AppData\Roaming\npm"
  

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