在 Visual Studio Code (VS Code) 中配置 MSYS2 Shell（如 UCRT64, MinGW64 等）最稳健的方法是通过修改 settings.json 配置文件。

以下是详细的步骤，假设你的 MSYS2 安装在默认路径 C:\msys64。

1. 打开设置文件 (settings.json)

1. 在 VS Code 中按下快捷键 Ctrl + Shift + P 打开命令面板。
2. 输入 Open Settings (JSON) 并选择 “首选项：打开用户设置 (JSON)” (Preferences: Open User Settings (JSON))。

2. 添加终端配置

在 settings.json 的大括号 { ... } 中，添加（或修改）terminal.integrated.profiles.windows 部分。

这里推荐使用 UCRT64 环境（MSYS2 推荐的现代标准），如果你需要 MinGW64，只需将代码中的 UCRT64 替换为 MINGW64 即可。

JSON

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

    "terminal.integrated.profiles.windows": {
        "MSYS2 UCRT64": {
            "path": "C:\\msys64\\usr\\bin\\bash.exe",
            "args": [
                "--login",
                "-i"
            ],
            "env": {
                "MSYSTEM": "UCRT64",
                "CHERE_INVOKING": "1",
                "MSYS2_PATH_TYPE": "inherit"
            },
            "icon": "terminal-bash"
        }
    },
    // 可选：将其设置为默认终端
    "terminal.integrated.defaultProfile.windows": "MSYS2 UCRT64",

关键参数解释

• path: 指向 MSYS2 内部的 bash 可执行文件。注意：路径中的反斜杠需要转义（即使用 \\）。
• args: ["--login", "-i"] 确保 shell 作为登录 shell 启动，加载所有必要的配置文件（如 .bashrc）。
• MSYSTEM:
  • UCRT64: 使用现代的 Universal C Runtime (推荐)。
  • MINGW64: 使用旧版的 MSVCRT (传统 MinGW)。
• CHERE_INVOKING: “1”: 非常重要。这告诉 bash 保持在当前工作目录（即你 VS Code 打开的项目文件夹），而不是跳转到 MSYS2 的用户 Home 目录。
• MSYS2_PATH_TYPE: “inherit”: (可选) 允许你在 MSYS2 终端中使用 Windows 系统环境变量中的工具（例如 Windows 上安装的 Python 或 Node.js）。如果你希望环境纯净，可以删掉这一行。

3. 验证与使用

1. 保存 settings.json 文件。
2. 按下 Ctrl + ` 打开终端面板。
3. 点击终端面板右上角的 + 号旁边的下拉箭头。
4. 你应该能看到 “MSYS2 UCRT64” 的选项，点击即可启动。

常见问题排查

• 乱码问题: 如果中文显示乱码，请确保你的系统区域设置支持 UTF-8，或者在 MSYS2 的 .bashrc 文件中添加 export LANG="zh_CN.UTF-8"。
• 路径不同: 如果你的安装路径不是 C:\msys64，请务必修改 JSON 中的路径。

您希望我帮您配置 tasks.json 以便直接在 VS Code 中使用 gcc 或 make 编译项目吗？