Windows 上配置 VS Code 集成终端与 Git Bash

这篇文章保留旧地址 tool/vscode/2，已替换 2022 年教程中的失效步骤。普通 Git for Windows 安装包不等同于 Git for Windows SDK；不应为了 pacman 安装 zsh 而下载 SDK。旧文将固定 GitHub IP 写入系统 hosts 的建议也已删除，不要照旧教程修改 DNS 解析。

先区分三件事：VS Code 是编辑器，集成终端是它启动的 shell 窗口，Git Bash 是 Git for Windows 提供的 Bash 环境。大多数 Windows 前端开发只需 Git for Windows 和 PowerShell 或 Git Bash，无需额外安装 Linux 子系统或把 zsh 塞进 Git Bash。

1. 安装 Git for Windows

从 Git for Windows 官方站点获取普通安装包。安装向导会询问 PATH、HTTPS 后端、换行符和默认终端等选项；不确定时保留安装器推荐值，后续可在仓库级配置中单独调整。下载 SDK 是为了构建 Git for Windows 或使用其额外开发工具，不是日常 Git Bash 的必要步骤；pacman 仅随 SDK 提供。

安装后打开新的 PowerShell 或命令提示符，确认：

git --version
where.exe git

where.exe git 如果列出多个安装位置，先确认 PATH 的优先顺序，避免 VS Code、Git Bash 和其他客户端各自调用不同版本。不要将凭据写进 remote URL；GitHub/Git 服务现在应使用受支持的 SSH key、系统 credential manager 或官方认证工具，而不是账号密码明文。

2. 选择 VS Code 终端 Profile

在 VS Code 终端下拉菜单选择 Terminal: Select Default Profile。VS Code 通常会自动发现 PowerShell 与 Git Bash。可以先保留 PowerShell 为默认，再按需要新建 Git Bash 终端；Profile 只是 shell 选择，不会改变系统的默认 shell。

需要显式固定 Git Bash 时，可在 Preferences: Open User Settings (JSON) 使用 Windows 专属 source 配置：

{
  "terminal.integrated.profiles.windows": {
    "Git Bash": {
      "source": "Git Bash"
    },
    "PowerShell (no profile)": {
      "source": "PowerShell",
      "args": ["-NoProfile"]
    }
  },
  "terminal.integrated.defaultProfile.windows": "Git Bash"
}

也可以在菜单中切换默认终端，而不把 defaultProfile 写入设置。若自动发现失败，再从安装器确认 Git Bash 的实际 bash.exe 路径，使用 path 指向它；不要复制旧文章中针对 SDK 的 msys2_shell.cmd、-mingw64 和 pacman 参数到普通 Git 安装。对于可被其他用户写入的可执行文件路径，VS Code 可能提示不安全；只选择可信且权限受控的安装目录。

如果需要 Linux 工具链，优先评估 WSL 并使用 VS Code Remote - WSL；它和 Git Bash 是不同环境。不要在 Git Bash 中混用 Windows、MSYS 与 WSL 的 Node、Python、SSH agent 路径，项目实际调用哪个工具以 type -a / where.exe 检查结果为准。

3. 目录、路径与换行符

Git Bash 使用类 Unix 路径，PowerShell 使用 Windows 路径。切换 shell 后检查工作目录、脚本解释器、路径分隔符和项目的运行命令。仓库的 .gitattributes、锁文件和 CI 配置优先于个人全局设置。对跨平台文本仓库，常见选择是将文本在提交时规范为 LF，但是否使用 core.autocrlf 应遵循项目团队约定；改配置后不要对整个仓库盲目重写换行符。

打开陌生仓库前先检查 .vscode/tasks.json、调试配置、package.json scripts 和扩展推荐。VS Code 终端以编辑器当前用户权限运行；workspace task 与扩展可能执行代码。可疑项目先使用 Restricted Mode，不要因“终端无法运行”就以管理员身份打开编辑器。

4. 安全排查安装与网络错误

如果下载或安装时出现 Could not resolve host、TLS 或连接失败，先记录完整错误和当前网络环境，再检查系统 DNS、代理、系统时间、证书链和网络策略。对目标域名使用当前 DNS 查询结果和官方状态页面；不要把临时 IP 固定写入 hosts，也不要关闭 TLS 校验或改用来源不明的镜像脚本。错误消失后再重试官方安装器，并验证签名/发布来源。

更新 Git for Windows 使用官方安装器或官方支持的更新流程。不要运行网上复制的 pacman 命令，除非你确实安装的是 Git for Windows SDK 且理解它维护的是哪套工具。安装第三方 shell 插件前核对仓库、维护状态和脚本；插件按当前 Windows 用户权限执行。

5. 验收与恢复

git --version 与 where.exe git 指向预期安装；
PowerShell 和 Git Bash 都能打开正确的仓库目录；
git status --short --branch、项目指定的依赖安装命令和测试脚本正常；
新终端可以再次启动，字体/主题不会遮挡错误和长路径；
出现异常时用 Terminal: Select Default Profile 切回 PowerShell，移除刚加入的自定义 Profile 后重试。

VS Code 官方文档：Terminal Profiles、Profiles；Git for Windows 的安装和发行信息见官方站点。