command not found报错主因是PATH未正确配置，需分四步排查：一查当前PATH值是否含目标目录；二用which/type/ls验证命令是否存在及权限；三确认对应shell配置文件（如~/.bashrc）是否被加载；四区分执行主体（如sudo、cron、systemd）的环境隔离特性。
遇到 command not found 报错，八成是 PATH 没配对——不是命令没装，而是 shell 根本没去对地方找。排查关键不在于“重试一遍”，而在于分清楚：当前环境是谁、PATH 真实值是多少、命令到底在哪儿、谁在执行它。
一、先看当前 PATH 是否包含目标路径
打开终端，直接运行：
-
echo $PATH—— 查看当前会话实际生效的 PATH 字符串 -
printenv PATH—— 效果同上，更明确指向环境变量本身 -
env | grep PATH—— 排查是否有其他同名变量干扰（如大小写混用）
重点观察输出中是否含有你期望的目录（比如 /usr/local/bin、~/.local/bin 或自定义路径）。注意路径之间必须用英文冒号 : 分隔，不能是分号或空格；路径本身也不能含中文、空格或未转义的特殊字符。
二、确认命令是否存在且可执行
别假设“装了就一定在 PATH 里”。手动验证目标程序位置：
-
which command_name—— 只返回第一个匹配的完整路径（如/usr/bin/python3） -
type -a command_name—— 显示所有同名命令（包括别名、函数、外部文件），能发现隐藏覆盖 -
ls -l /path/to/expected/command—— 检查文件是否存在、是否具有x权限（如-rwxr-xr-x）
例如，which docker 返回空，但 ls /usr/bin/docker 存在且有执行权限，说明问题出在 PATH 缺失该路径，而非 Docker 未安装。
Browser Setup (No-Root Linux)
下载
在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...
三、检查配置文件是否被加载、何时生效
改了 ~/.bashrc 却没效果？可能根本没加载。不同登录方式加载的文件不同：
- 交互式登录 shell（如 SSH 登录、图形终端首次启动）：通常加载
~/.profile或/etc/profile - 交互式非登录 shell（如 GNOME Terminal 新建标签页）：默认只加载
~/.bashrc - 脚本或 systemd 服务：几乎只继承最小 PATH（常为
/usr/bin:/bin），不读用户配置文件
验证某文件是否生效：在对应配置文件末尾加一行 echo "loaded ~/.bashrc"，新开终端看是否打印。若没打印，说明该文件未被 source。
四、区分执行主体与环境隔离场景
很多报错出现在“手工能跑，自动就失败”时，本质是执行环境不同：
-
sudo command：默认不继承普通用户 PATH，除非加-E（sudo -E command）或配置env_keep - Cron 定时任务：PATH 固定为
/usr/bin:/bin，需在脚本开头显式设置完整 PATH 或用绝对路径调用命令 - systemd 服务：需在 service 文件中用
Environment=PATH=...明确声明，不能依赖用户级配置
临时测试可模拟环境：env -i PATH="/usr/local/bin:/usr/bin:/bin" command_name，排除其他变量干扰。
