如何定义需source而非运行的Shell脚本？含用户提示及防执行方案

嘿，这个问题问得特别实用！咱们一步步来解决你的三个疑问：

其实这类脚本本身不需要特殊的“定义”语法，核心是它的作用是修改当前Shell进程的环境——比如设置环境变量、定义别名/函数、调整Shell配置，这些操作必须在当前进程里生效，而不能启动一个子进程（直接运行脚本会启动子进程，执行完就消失了，不会影响当前Shell）。

所以你只需要按照正常Shell脚本写，但注意几个细节：

• 不要用exit命令（除非是判断直接执行时的退出逻辑），不然会把当前Shell关掉；
• 如果要让变量在当前Shell生效，不要加local修饰（local只在函数内生效）；
• 函数直接定义即可，source后就能在当前Shell调用。

有几个常规且智能的方式：

• 用特殊扩展名区分：别用普通的.sh，可以换成.env（适合环境变量脚本）、.shrc、.src.sh，或者直接.source，用户一看扩展名就知道不能直接跑；
• 脚本开头加醒目的注释：比如在脚本最开头写清楚：

#!/usr/bin/env bash
# ⚠️ 重要提示：此脚本必须使用 source 或 . 命令加载，不能直接执行！
# 正确示例：source ./project_setup.src.sh
# 作用：配置项目专属的环境变量和快捷命令

• 文件名直观命名：比如叫load_project_env.source或者setup_shell_functions.source，名字直接告诉用户用法。

这是最稳妥的办法，直接在脚本开头加一段判断逻辑，当用户直接执行时自动提示并退出，不会误操作。

针对Bash的写法（最常用）： #

#!/usr/bin/env bash

# 检查是否是直接执行（而非source）
if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
    echo "❌ 错误：此脚本不能直接执行，请用 source 或 . 命令加载！"
    echo "✅ 正确用法：source ${BASH_SOURCE[0]} 或 . ${BASH_SOURCE[0]}"
    exit 1
fi

# 下面是你的脚本核心内容
export PROJ_DIR="/home/yourname/my_project"
alias proj="cd $PROJ_DIR"
function build_proj() {
    cd $PROJ_DIR && make && ./output
}

原理：${BASH_SOURCE[0]}是当前脚本的路径，直接执行时$0等于这个路径；如果是source的话，$0是当前Shell的名称（比如bash），两者不相等，所以不会触发提示。

兼容POSIX Shell的写法（比如sh、dash）： #

如果你的脚本要兼容更通用的POSIX Shell，可以用这个判断：

#!/bin/sh

if [ "$0" = "$_" ]; then
    echo "❌ 错误：此脚本不能直接执行，请用 source 或 . 命令加载！"
    echo "✅ 正确用法：source $0 或 . $0"
    exit 1
fi

# 核心内容...

这样用户哪怕不小心直接运行脚本，也会立刻看到正确用法，不会搞错啦！

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