在 Bash 中定义可直接调用的自定义命令应使用函数而非 alias，写入 ~/.bashrc 并 source 生效；函数名用小写加下划线，参数用 "$@" 透传，路径和空格需加引号处理，注意非交互式场景需显式 source 或复制定义。
如何在 Bash 中定义一个可直接调用的自定义命令
自定义命令本质是 Bash 函数或脚本，被 shell 识别并加载后即可像 ls 那样直接输入执行。关键不是“放哪”，而是“是否被当前 shell 环境读取”。最稳妥的方式是写成函数，加到 ~/.bashrc（用户级）或 /etc/bash.bashrc（系统级），然后执行 source ~/.bashrc 生效。
常见错误：只写进 ~/.bash_profile 却在非登录 shell（比如终端新建标签页）里调用，结果提示 command not found——因为多数桌面终端启动的是交互式非登录 shell，只读 ~/.bashrc。
- 函数名不能含短横线（
-）或空格，推荐小写字母+下划线，如git_st - 避免覆盖已有命令，可用
type 命令名检查是否已存在 - 函数体里用
$@透传所有参数，比硬写$1 $2更健壮
为什么 alias 不够用，必须用 function
alias 只做简单文本替换，不支持条件、循环、变量作用域控制；一旦涉及逻辑判断、参数处理或环境检查，就必须上函数。比如想实现“只在 Git 仓库里才执行 git status”，alias 完全无能为力。
典型场景：ll 这类 alias 能胜任，但类似 mkcd（创建目录并进入）这种需要两步操作的，必须用函数：
mkcd() {
mkdir -p "$1" && cd "$1"
}
注意这里用了 "$1" 而不是 $1，防止路径含空格时报错；&& 保证只有创建成功才进入，比 ; 更安全。
函数里如何正确处理路径和空格参数
Bash 函数对参数默认按空白符分割，没引号包裹就会断开。这是最常导致“文件不存在”或“参数个数错误”的原因。
- 所有用户输入参数一律用双引号包裹：
"$1"、"$@" - 拼接路径时用
$(pwd)或$PWD，别手写/home/user/xxx——路径可能软链接或挂载点不同 - 要用
cd -P处理符号链接路径，避免cd ..返回意外位置 - 检测目录是否存在用
[ -d "$1" ]，不要用ls "$1" &>/dev/null这种低效又不可靠的方式
让自定义命令在子 shell 和脚本中也能用
函数默认只在当前 shell 会话有效。如果新开终端、运行脚本、或用 bash -c "myfunc"，函数就消失了。
- 确保函数定义在
~/.bashrc，且该文件被所有交互式 shell 加载 - 若需在非交互式场景（如 cron、脚本）中使用，要么把函数定义复制进脚本头部，要么在脚本开头显式
source ~/.bashrc - 注意
~/.bashrc开头常有[ -z "$PS1" ] && return这类守卫代码，会阻止非交互式 shell 加载函数——删掉或注释它（仅当你确认需要时）
真正麻烦的不是写函数，而是让函数在各种上下文里稳定存在；尤其当别人接手你的脚本或服务器时，隐式依赖 ~/.bashrc 很容易出问题。
