在macOS上修复Zsh命令未找到错误的5种已验证方法 [Bash & Zsh]

在2019年，macOS发布了Catalina版本，从那时起，Mac将默认的登录shell从Bash切换到了Zsh。因此，系统更新后，一些Zsh命令可能无法使用。使用macOS Catalina或更高版本（如Big Sur、Monterey和Ventura）的用户可能会收到类似于“**Zsh：未找到命令**”的错误提示，接下来我们将讨论这个问题。其他Zsh：未找到命令的错误还包括Zsh：未找到命令：brew、Zsh命令未找到：pip、Zsh：未找到命令：nvm或Zsh：未找到命令：npm等。出现这种错误可能有多种原因。

Mac 上出现 Zsh 命令未找到错误的原因

在使用Unix、Linux或macOS时，许多用户会遇到“Zsh命令未找到”的问题。用户们经常在论坛上搜索解决方法。因此，我们决定提供所有可能的解决方案来解决这个问题。首先，“Zsh：命令未找到”通常是由于以下原因造成的：

在MAC上拼写错误的Zsh命令

当用户首次在Mac上使用Zsh命令时，他们通常会犯诸如添加额外符号或在需要空格的地方遗漏空格等错误。拼写错误的命令对macOS来说是无法识别的。因此，系统会提示你命令错误。如果你遇到“zsh命令未找到”的问题，请确保你输入的命令是正确的。

2. 命令有效，但该包未安装。

用户经常尝试执行一个命令，但所需的软件包没有安装，所以他们会看到“Zsh 命令未找到”的消息。当命令是有效且拼写正确时，用户最好检查他们是否已经安装了必要的软件包。

3. Zsh 命令默认环境配置的更改

随着macOS更新到新版本，命令的典型环境会有所变化，大多数Linux bash命令可以保存，但并不适用于Zsh命令。因为默认情况下，Zsh不会从先前指定的地址读取环境变量。

如何用5种解决方案修复Zsh命令未找到错误 在使用Zsh shell时，你可能会遇到“Zsh 命令未找到”错误。这通常是由于命令路径未正确配置或者相关软件包未安装导致的。以下是一些解决此问题的方法： 1. **更新路径**： 确保你的命令存在于`$PATH`环境变量中。打开`.zshrc`配置文件（通常位于`~/.zshrc`），然后添加或确认命令的路径： ```bash nano ~/.zshrc ``` 在文件末尾添加或修改`PATH`： ```bash export PATH=$HOME/bin:/usr/local/bin:$PATH ``` 根据需要添加其他路径，并保存更改后，运行： ```bash source ~/.zshrc ``` 2. **安装软件包**： 如果是特定命令未找到，可能需要安装相应的软件包。例如，如果你在macOS上，可以使用Homebrew来安装： ```bash brew install ``` 3. **检查别名**： 检查`.zshrc`文件中是否有任何别名定义。有时，命令可能是以别名的形式存在的： ```bash grep -i alias ~/.zshrc ``` 如果找到了，确保在终端中使用正确的别名。 4. **重新加载Zsh配置**： 如果你最近修改了`.zshrc`文件，可能需要重新加载配置以应用更改： ```bash source ~/.zshrc ``` 5. **恢复默认配置**： 如果以上方法都无效，你可以考虑恢复Zsh的默认配置。首先备份你的`.zshrc`文件，然后替换为默认配置： ```bash mv ~/.zshrc ~/.zshrc.bak cp /etc/zsh/zshrc ~/.zshrc source ~/.zshrc ``` 通过尝试这些解决方案，你应该能够解决“Zsh 命令未找到”的错误。如果问题依然存在，可能需要进一步调查，如检查系统日志或寻求社区支持。

在Mac上，你可能会在多种情况下遇到Zsh：命令未找到的问题。无论是在macOS Monterey还是其他使用z-shell的macOS版本上，都可能出现这个错误消息。

在开始这5个解决方案之前，你可能先要看一下以下关于修复Zsh 命令未找到错误的方法的教程视频。

• 00:00 - 引言
• 00:40 - 检查终端是Zsh还是bash
• 01:08 - 下载Mac版的MySQL服务器
• 02:51 - 创建.zprofile
• 04:15 - 配置MySQL的路径
• 05:00 - 使用mysql -u root -p

如果你仍然对修复错误有疑问，请继续阅读下面的解决方案。

• 1. 检查语法
• 2. 确保软件包已安装
• 3. 设置 $Path 环境变量
• 4. 在 .zshrc 文件中设置路径
• 5. 重新安装 macOS

解决方案1：检查语法，当Zsh命令未找到时

当在Mac的Terminal中遇到“Zsh：命令未找到”的消息时，首先应检查命令的语法。最好将原始内容复制到Terminal中，而不是手动输入。此外，将你的命令与其他使用相同命令的例子进行比较也会很有帮助。

解决方案2：确保安装了Zsh命令的包

你经常尝试执行一个命令，但所需的软件包没有安装。如果您的命令是有效且拼写正确的，这是否意味着你需要检查是否已经安装了必要的软件包呢？答案是否定的。当你知道Zsh命令未找到时，确保你没有忘记在你的Mac上安装该命令所需的软件包。

解决方案3：设置$PATH环境变量以修复Zsh命令未找到问题

要解决“Zsh: 命令未找到错误”，第二个解决方案是确保“$PATH”环境变量配置正确。

如果你已经安装了软件包，但仍然收到“Zsh：命令未找到”错误，那么可能出现了问题。这表明你需要为你的命令包创建一个PATH变量。

以下是一个设置导出PATH的示例：

大多数软件包会自动在macOS 更新或干净安装中设置路径变量。当进行自定义安装时，你可能偶尔需要在 Linux 或 macOS 中手动设置路径变量。

解决方案4：在.zshrc文件中设置Zsh命令路径

在安装了软件包并设置好路径变量后，如果你退出并重新登录终端，但仍然看到错误 Zsh 命令未找到，你需要在 .zshrc 文件 中配置命令路径以使其生效。

每次关闭并重新打开终端时，你的.zshrc文件将会运行并设置命令路径。要编辑.zshrc文件，请按照以下步骤操作。

第一步：打开macOS终端。

**第二步：** 确认你正在使用 Zsh Shell；如果不是，请输入 **zsh** 并按回车键进行检查。

第三步：在窗口中输入 nano ~/.zshrc。

第4步：现在添加你的$PATH变量信息

（图片显示的是macOS上的zshrc文件）

步骤 5: 要保存文件，按 Ctrl + X，然后按 Y，再按 Enter 以关闭 Nano 编辑器。

第六步：执行命令source ~/.zshrc以应用更改。

解决方案5：重新安装macOS以修复Zsh命令未找到问题

如果您在浏览macOS时不小心删除了终端命令所需的一些文件，或者意外破坏了特定的系统文件或文件夹，那么可能会发生这种情况。如果发生这种情况，您应该尝试从垃圾箱恢复已删除的Mac文件。

如果不格式化硬盘，重新安装macOS 可以让你恢复到之前的设置并修复Zsh命令未找到的问题。虽然重新安装操作系统通常不会导致数据丢失，但首先备份重要文件仍然是明智的。如果你找不到重要的数据，可以尝试在重新安装macOS后恢复文件。

附加信息：如何在Mac上恢复已删除的数据

如我们在解决方案5中提到的，重新安装macOS是解决Zsh命令未找到错误的有用方法。但是，重新安装或更新后恢复删除的文件对于Mac也至关重要。

关注保护你的数据是很有益的，因为错误的更新过程或命令可能导致丢失文件和数据。这里有一个出色的数据恢复工具，特别是对于Mac上的Mac Trash恢复：tools Data Recovery Wizard for Mac。

查看步骤，学习如何使用软件在Mac上恢复已删除的文件。

注意：您可以通过首先在左侧单击“磁盘备份”来创建Mac的备份。该软件将从备份映像中恢复已删除的文件。这可以防止对您的磁盘和数据造成进一步损坏，使其更安全、更可靠。

第一步：选择位置并扫描

启动tools Data Recovery Wizard for Mac，选择丢失数据的磁盘。然后，点击“搜索丢失的文件”开始扫描。

第二步：筛选并预览丢失的文件

扫描完成后，可以使用左上或右上角的文件格式过滤器来找到你需要的已删除文件。

第三步：恢复丢失的数据或文件

您可以双击文件预览其内容，或选择多个文件以一次性恢复它们。点击“恢复”将丢失的数据恢复到本地或云驱动器。

总结一下

总的来说，“Zsh 命令未找到”问题是由 bash shell 和 Zsh shell 之间的差异引起的。不同版本的 macOS 可能无法完全兼容。如果你刚刚更新了你的 Mac，并发现你的 Zsh 命令出现问题，我们希望以下的解决方案能对你有所帮助。此外，你的 Mac 设备可以借助 tools Data Recovery Wizard for Mac 有效地保护你的数据。

Zsh 命令未找到常见问题解答

这里，我们列出了4个你可能也感兴趣的问题。一起来看看并找到答案吧。

**1. Zsh 是Mac的默认 shell 吗？**

在macOS Catalina之后，zsh成为了Mac的默认shell。但是在Catalina之前的macOS版本中，zsh并不是默认的命令行shell。

**2. 如何在Mac上启动Zsh？** 要在Mac上启动Zsh，你可以按照以下步骤操作： 1. 打开终端(Terminal)。你可以在Launchpad中的"其他"文件夹里找到它，或者通过Spotlight搜索来打开。 2. 在终端窗口中输入以下命令以切换到Zsh shell： ``` chsh -s /bin/zsh ``` 这个命令会将你的默认shell更改为Zsh。你需要输入密码以进行此更改。 3. 退出并重新打开终端，或者使用`exec zsh`命令来立即切换到Zsh会话。 4. 现在你应该已经启动了Zsh。你可以通过输入`echo $SHELL`来确认当前使用的shell。 如果你想要自定义Zsh配置，可以创建或编辑`.zshrc`文件，添加个性化设置和别名。

打开“Shell”标签 - 点击“运行命令” - 输入“zsh”。

**如何在Mac上打开Zsh终端？**

第一步：点击Mac dock栏中的Launchpad图标。 第二步：在搜索框中输入“Terminal”。 第三步：点击出现的Terminal应用程序。 第四步：在Terminal中输入“Zsh”以启动它。

如何解决macOS的“Zsh：找不到brew命令”错误？

请确保已经正确安装了Homebrew，并且路径变量设置正确。

步骤 1. 使用命令 `nano ~/.zshrc` 打开.zshrc文件。 步骤 2. 在文件中添加以下代码：`export PATH="$PATH:/opt/homebrew/bin/"` 步骤 3. 使用 `Control + X` 保存文件，然后按 `Y` 确认保存。 步骤 4. 在命令行中输入 `source ~/.zshrc` 以应用更改。