配置Git提醒使用switch/restore替代checkout命令

一、Git官方内置机制说明 #

首先明确：Git目前没有官方配置项可以直接禁用git checkout或自动触发警告。该命令并未被标记为“已弃用”，只是Git推出switch和restore来拆分它的功能，让命令语义更清晰，因此官方不会强制限制checkout的使用。

二、最优实现方式：自定义Bash函数（灵活可控） #

既然官方无内置方案，自定义Bash函数是最直接的解决办法，还能根据checkout的具体操作给出针对性提醒：

1. 打开你的Bash配置文件（如~/.bashrc或~/.bash_profile）
2. 添加以下函数代码：

git() {
    if [[ "$1" == "checkout" ]]; then
        # 判断操作类型：分支切换还是文件恢复
        if [[ -n "$2" && "$2" != -* ]]; then
            echo -e "\033[31m⚠️  警告：建议使用 \`git switch $2\` 替代当前分支切换操作\033[0m"
        else
            echo -e "\033[31m⚠️  警告：建议使用 \`git restore\` 替代当前文件恢复操作\033[0m"
        fi
    fi
    # 执行原始git命令，避免循环调用
    command git "$@"
}

3. 使配置立即生效：source ~/.bashrc

函数细节说明 #

• 针对分支切换操作（git checkout <分支名>），提示改用git switch
• 针对文件恢复操作（git checkout <文件路径>或带参数的恢复），提示改用git restore
• 用\033[31m和\033[0m让警告文字显示为红色，提升醒目度
• command git "$@"确保原始Git命令正常执行，不会陷入函数循环

三、进阶：严格模式（阻止git checkout执行） #

如果想强制自己彻底停用git checkout，可以修改函数，在警告后终止命令执行：

git() {
    if [[ "$1" == "checkout" ]]; then
        if [[ -n "$2" && "$2" != -* ]]; then
            echo -e "\033[31m❌  禁止使用：请用 \`git switch $2\` 替代分支切换\033[0m"
        else
            echo -e "\033[31m❌  禁止使用：请用 \`git restore\` 替代文件恢复\033[0m"
        fi
        return 1
    fi
    command git "$@"
}

四、临时绕过提醒 #

如果偶尔需要使用git checkout，可以直接调用原始命令绕过函数拦截：

command git checkout <分支/文件>

内容的提问来源于stack exchange，提问作者MakisH