VSCode启动配置无法覆盖fish默认环境变量问题求助

问题现象 #

当VSCode将fish设为默认用户shell时，无法通过launch配置覆盖fish设置的环境变量。示例如下：

1. fish配置文件$XDG_CONFIG_HOME/fish/config.fish中的设置：

set -x FOO BAR

2. VSCode的.vscode/launch.json配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "My launch",
            "type": "cppdbg",
            "request": "launch",
            "program": "/bin/sh",
            "args": ["-c", "echo $FOO"],
            "environment": [
                {
                    "name": "FOO",
                    "value": "OVERWRITTEN"
                }
            ],
            "cwd": "${workspaceFolder}"
        }
    ]
}

预期输出为OVERWRITTEN，但实际运行后得到BAR。

原因分析 #

核心差异在于bash和fish对非交互模式的处理逻辑：

• bash在非交互模式下，默认不会加载~/.bashrc这类用户配置文件（除非显式设置了BASH_ENV环境变量），因此VSCode预先设置的环境变量不会被覆盖。
• fish则不同，无论是否为交互模式，默认都会加载config.fish配置文件。VSCode的调试流程是先设置好指定的环境变量，再通过用户默认shell（fish）启动目标程序，此时fish加载config.fish时会重新设置FOO，从而覆盖了VSCode的配置。

能否避免使用用户shell？ #

可以。在launch.json的调试配置中，通过"shell"字段指定其他shell（比如bash），或者直接以非shell方式启动目标程序（如果调试器支持）：

{
    // 其他配置项...
    "shell": "/bin/bash"
}

不过这种方式只是临时规避，无法从根源解决fish配置对非交互场景的影响。

最佳实践 #

1. 区分交互/非交互场景配置：
   将只需要在交互shell（比如终端手动打开的fish）中生效的环境变量和配置，用if status is-interactive包裹，这样非交互场景（比如VSCode启动的fish）就不会加载这些内容：

   if status is-interactive
       set -x FOO BAR
       # 其他仅交互环境需要的配置...
   end
   

2. 合理存放环境变量：
   • 系统级、全局生效的环境变量，建议放在~/.profile或/etc/profile中，fish会自动读取这些文件的内容，且不会影响非交互场景的变量覆盖。
   • 仅交互环境需要的个性化配置，放在config.fish的交互判断块内。

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