正确做法是用软链接指向有shebang和执行权限的脚本，并确保/usr/local/bin在path前置位置；也可用alias实现单用户快速调用。
直接把脚本放进 /usr/local/bin 并不行——系统默认不执行没有可执行权限的文件，也不认非二进制文件为命令。正确做法是：用软链接指向脚本本身，并确保它有执行权限、有正确的解释器声明（shebang）。
确认脚本具备可执行基础
你的脚本必须满足两个硬性条件，否则软链接建了也白搭：
-
首行写明 shebang，比如
#!/usr/bin/env bash或#!/usr/bin/env python3，不能省略； -
设置可执行权限：运行
chmod +x /path/to/your-script.sh； - 建议用绝对路径保存脚本（如
~/bin/deploy.sh），避免链接后因相对路径失效。
在 /usr/local/bin 下创建软链接
链接目标是脚本文件本身，不是它的父目录，也不是包装命令：
- 例如脚本在
~/bin/backup.sh，运行：ln -sf "$HOME/bin/backup.sh" /usr/local/bin/backup -
-s表示软链接，-f覆盖已存在的同名项（安全起见可先ls -l /usr/local/bin/backup确认）； - 链接名（这里是
backup）就是你之后在终端输入的命令名，无需加.sh后缀。
确保 /usr/local/bin 在 PATH 前置位置
软链接放对了，终端还得“看得见”。检查当前 PATH 是否包含且前置 /usr/local/bin：
- 运行
echo $PATH，确认输出开头或紧邻/opt/homebrew/bin后出现/usr/local/bin； - 如果没出现或靠后，在
~/.zshrc末尾添加：export PATH="/usr/local/bin:$PATH" - 保存后执行
source ~/.zshrc，再用which backup验证是否返回/usr/local/bin/backup。
替代方案：用 alias 更轻量（适合单用户、调试阶段）
如果你只是给自己用，不希望影响其他用户或脚本调用，alias 是更干净的选择：
- 在
~/.zshrc中添加：alias backup="$HOME/bin/backup.sh" - 执行
source ~/.zshrc即可使用； - 注意：alias 只在交互式 shell 生效，写在 shell 脚本里调用
backup会失败，此时必须用完整路径或改用函数封装。
