为何在函数中source脚本时Bash变量不具备全局特性？

这个问题其实是Bash中函数作用域与source命令交互的一个常见误区，咱们结合手册内容和实际场景来拆解：

先澄清手册描述的真实含义 #

你提到的手册内容并没有矛盾，只是需要结合细节理解：

• 函数章节："函数局部变量可通过local内置命令声明，通常函数与其调用者共享变量及值"——这里的"通常"指的是未用local声明的变量，函数和全局环境共享；一旦用local声明，变量就被限制在函数作用域内。
• source章节："在当前shell环境中读取并执行filename中的命令"——这里的"当前shell环境"，在函数内部时，就是函数的执行环境，而函数的执行环境会继承全局环境，但如果有局部变量声明，会优先覆盖。

你遇到问题的常见场景 #

最可能的情况是：你的函数内部已经用local声明了和source脚本中同名的变量，导致source脚本对该变量的赋值被限制在函数的局部作用域，函数退出后局部变量销毁，全局环境中看不到这个变量。

举个例子：
假设你有一个被source的脚本config.sh：

APP_NAME="myapp"
APP_VERSION="1.0.0"

你的主脚本（错误示例）：

load_config() {
    local APP_NAME  # 这里声明了局部变量，会覆盖全局同名变量
    source config.sh
}

load_config
echo $APP_NAME  # 输出为空，因为source的赋值给了局部变量，函数退出后局部变量消失

而如果函数里没有同名local变量，source后的变量就是全局的（正确示例）：

load_config() {
    source config.sh
}

load_config
echo $APP_NAME  # 输出"myapp"，变量是全局的

其他可能的原因 #

如果上面的场景不符合你的情况，还有两种少见但可能的情况：

• 你的函数开启了set -o localvars（部分Bash版本支持）：这个选项会让函数内的所有变量默认是局部的，即使没有用local声明，这会导致source的变量也被限制在函数内。可以用set +o localvars关闭这个选项。
• source的脚本内部用local声明了变量：如果被source的脚本里用local定义变量，那这些变量自然只在当前函数的作用域内（因为source是在函数环境执行的），函数退出后就会消失。

解决办法 #

根据你的场景选择对应的方案：

• 移除函数内同名的local声明：如果不需要该变量是局部的，直接删掉local VAR_NAME这一行。
• 显式将变量声明为全局：如果必须在函数内保留local声明，但又想让source的变量全局生效，可以用declare -g在source后强制将变量转为全局：

  load_config() {
      local APP_NAME
      source config.sh
      declare -g APP_NAME  # 将局部变量转为全局
  }
  

• 检查环境选项：用set -o查看是否开启了localvars，如果是，用set +o localvars关闭。

内容的提问来源于stack exchange，提问作者android.weasel