为何导出的Shell函数在VS Code集成终端中无法访问？

在Ubuntu 22.04系统上使用VS Code 1.97.2时，遇到环境配置问题如下：

为工作区编写了预配置环境脚本script-helpers.sh，内容如下：

#!/bin/bash

if [ -n "${SCRIPT_HELPERS_LOADED}" ]; then
    logDebug "Script helpers already loaded!"

    return 0
fi

# Some functions and variables...

for func in $(declare -F | awk '{print $3}'); do
    if [[ "${func}" != _* ]]; then
        logDebug "Exporting function: '${func?}'"

        export -f "${func?}"
    fi
done

export SCRIPT_HELPERS_LOADED=1

logInfo "Environment set up."

在终端中先source该脚本，可正常使用导出的函数：

projectFolder$ source scripts/script-helpers.sh
[L70][INFO] Environment set up.
projectFolder$ logInfo "Just a message."
[L2][INFO] Just a message.
projectFolder$ code .

但启动VS Code后，集成终端仅能访问导出的变量，无法访问导出的函数：

projectFolder$ echo $SCRIPT_HELPERS_LOADED 
1
projectFolder$ logInfo "Another message"
logInfo: command not found 

方法1：通过bash子进程启动VS Code #

VS Code默认启动时不会完全继承父shell的函数环境，export -f导出的函数仅在当前shell会话及直接子进程中有效。可通过以下命令启动VS Code，强制它继承父shell的函数：

projectFolder$ bash -c "code ."

此方式启动的VS Code会在bash子进程中运行，集成终端可正常使用logInfo等导出函数。

方法2：在shell配置文件中自动加载脚本 #

若希望每次打开VS Code集成终端都自动加载环境脚本，可修改shell配置文件：

• 若使用bash，编辑~/.bashrc或项目目录下的.bashrc，添加：

  [ -f "/path/to/your/project/scripts/script-helpers.sh" ] && source "/path/to/your/project/scripts/script-helpers.sh"
  

• 若使用zsh，编辑~/.zshrc，添加上述同样内容。

注意：若使用项目级配置，需在VS Code设置中开启对应shell的项目配置读取权限。

方法3：修改VS Code终端启动配置 #

在VS Code中直接配置终端启动命令，让它自动加载脚本：

1. 打开VS Code设置（快捷键Ctrl+,）
2. 搜索terminal.integrated.profiles.linux
3. 编辑默认bash配置，将启动命令改为：

   bash --init-file /path/to/your/project/scripts/script-helpers.sh
   

   若需保留原bashrc的配置，可改为：

   bash --rcfile <(cat ~/.bashrc /path/to/your/project/scripts/script-helpers.sh)
   

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