VS Code中GCC任务执行报错：终端进程启动失败（退出码-1）求助

一、确认GCC已安装并配置到系统PATH #

• 打开系统自带终端（Windows用CMD/PowerShell，Linux/macOS用Terminal），输入gcc --version
• 能输出GCC版本号说明安装正常；若提示“找不到命令”，按以下方式处理：
  • Windows：安装MinGW-w64并勾选gcc组件，将MinGW的bin目录（如C:\mingw64\bin）添加到系统环境变量PATH，添加后重启终端和VS Code再验证
  • Linux：执行sudo apt install gcc（Debian/Ubuntu系）或sudo dnf install gcc（Fedora系）
  • macOS：执行xcode-select --install安装Xcode命令行工具

二、检查VS Code的tasks.json配置 #

• 打开C/C项目，按Ctrl+Shift+B（Windows/Linux）或Cmd+Shift+B（macOS），选择“创建tasks.json文件”→“C/C: gcc build active file”
• 重点核对command和args字段，正确配置示例：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: gcc build active file",
            "command": "gcc",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "编译器: gcc"
        }
    ]
}

• 若GCC非全局可调用，将command改为完整路径（如Windows下"C:\\mingw64\\bin\\gcc.exe"）
• 保存配置后重新尝试构建

三、检查VS Code终端路径设置 #

• 打开VS Code设置（快捷键Ctrl+,或Cmd+,），搜索对应系统的终端路径：
  • Windows：搜terminal.integrated.shell.windows，设置为C:\Windows\System32\cmd.exe或C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
  • Linux：搜terminal.integrated.shell.linux，设置为/bin/bash或/usr/bin/zsh
  • macOS：搜terminal.integrated.shell.osx，设置为/bin/bash或/bin/zsh
• 若之前修改过终端路径，改回默认值后重启VS Code

四、修复损坏的VS Code终端配置 #

• 关闭VS Code，找到用户配置目录：
  • Windows：%APPDATA%\Code\User
  • Linux：~/.config/Code/User
  • macOS：~/Library/Application Support/Code/User
• 删除settings.json中所有以terminal.integrated开头的配置项，或备份后直接删除settings.json（恢复默认设置）
• 重启VS Code后重新配置终端和tasks.json

五、Linux/macOS下检查权限问题 #

• 在系统终端手动编译代码：gcc 你的代码文件名.c -o 输出文件名，验证是否能正常编译
• 若手动编译失败，执行chmod +r 你的代码文件名.c赋予文件读取权限
• 必要时用sudo code启动VS Code（仅限Linux），确保程序有足够权限访问终端和GCC路径

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