在使用 macOS 或 Linux 系统时，很多人会遇到这样一个问题：明明安装了某个程序，但在终端里输入命令却提示“command not found”（找不到命令）。比如你装好了 Node.js，想运行 node -v 查看版本，结果终端回你一句：zsh: command not found: node。这时候别慌，问题出得挺常见，原因也基本逃不过这几个。
路径没加进环境变量 PATH
这是最常见的情况。系统靠 PATH 环境变量来知道去哪儿找你要执行的命令。如果你装的程序没有被放到 PATH 里的任何一个目录下，终端自然就“看不见”它。
比如你把某个工具装到了 /opt/mytool/bin，但这个路径不在 PATH 里，那直接敲 mytool 就会报错。可以这样查看当前的 PATH：
echo $PATH如果发现缺了关键路径，就可以手动加上。以 zsh 为例（macOS 默认 shell），编辑配置文件：
nano ~/.zshrc在文件末尾加上：
export PATH="/opt/mytool/bin:$PATH"保存后重新加载配置：
source ~/.zshrc再试命令，大概率就能用了。
安装路径写错了或根本没装成功
有时候你以为装好了，其实只是解压了个压缩包，或者安装脚本中途出错。比如你从官网下载了一个二进制文件放到桌面上，然后直接在终端里敲名字，那肯定找不到——你得进到桌面目录，或者用完整路径才能运行。
正确做法是把可执行文件移到系统能识别的位置，比如 /usr/local/bin（需要权限）：
sudo mv ~/Desktop/mytool /usr/local/bin/之后 anywhere 都可以直接敲 mytool 启动。
shell 配置文件没生效
改了 .zshrc 或 .bashrc 后忘了 source，或者新开终端也没自动加载，配置就不会生效。这种情况特别容易发生在刚配好环境的新机器上。
确认一下你当前用的是哪个 shell：
echo $SHELL如果是 /bin/zsh，那就该看 ~/.zshrc；如果是 /bin/bash，就该看 ~/.bash_profile 或 ~/.bashrc。别改错文件了。
多版本管理工具干扰
如果你用了 nvm、pyenv、rbenv 这类工具管理语言版本，那命令是否可用还取决于当前激活的版本。比如你用 nvm 装了多个 Node 版本，但没执行 nvm use 或设置默认版本，node 命令就不会出现在 PATH 中。
检查当前 Node 是否可用：
nvm current如果没有输出或显示 none，那就选一个已安装的版本：
nvm use --default 18.17.0这样 node 和 npm 才会进入 PATH。
符号链接缺失
有些软件安装后不会自动创建软链。比如你用 Homebrew 装完软件，它通常会自动处理，但手动安装时就得自己动手。
假设可执行文件在 /Applications/MyApp.app/Contents/MacOS/app，你可以给它做个软链到 /usr/local/bin：
sudo ln -s /Applications/MyApp.app/Contents/MacOS/app /usr/local/bin/myapp之后就能直接输入 myapp 来启动了。
这类问题看着烦人，其实大多数时候就是路径或配置的小疏忽。打开终端，一步步查 PATH、看配置、确认安装位置，基本都能搞定。