Windows 10下便携版VSCode集成便携版Git的配置问题求助

问题描述 #

我正在搭建可在U盘或网络驱动器上运行的便携开发环境，选用了便携版VSCode，已掌握扩展安装方法。现在希望集成便携版Git用于Windows 10设备，且不想修改目标机器的环境变量（因U盘盘符可能变化）。

目前卡在Git配置上：将便携Git放在VSCode主目录下的git文件夹中，设置绝对路径（如E:\Portable_VSCode1.82.0\git\bin\git.exe）可正常运行，但相对路径.\git\bin\git.exe仅初始化时能识别，调用时提示spawn ./git/bin/git.exe ENOENT错误。尝试过{%CD:~0,2%}、{env:CD}等路径写法均无效，旧教程中的terminal.integrated.shell.windows设置已废弃。当前使用VSCode 1.82.0及最新便携版Git，原settings.json配置如下：

{
    "workbench.colorTheme": "Default Dark Modern",
    "git.ignoreMissingGitWarning": true,
    "git.enabled": true,
    "git.path": ".\\git\\bin\\git.exe",
    "terminal.integrated.shellIntegration.enabled": true,
    "terminal.integrated.profiles.windows": {
      "PowerShell": { "source": "PowerShell", "icon": "terminal-powershell" },
      "Command Prompt": {
        "path": [
          "${env:windir}\\Sysnative\\cmd.exe",
          "${env:windir}\\System32\\cmd.exe"
        ],
        "icon": "terminal-cmd"
      },
      "GitBash": {
        "path": ["E:\\Portable_VSCode1.82.0\\git\\bin\\bash.exe"],
        "icon": "terminal-bash"
      },
  },
  "terminal.integrated.defaultProfile.windows": "GitBash",
    "editor.fontSize": 18,
    "editor.tabSize": 2,
    "editor.mouseWheelZoom": true,
    "editor.showFoldingControls": "always",
    "workbench.iconTheme": "vscode-icons",
    "workbench.sideBar.location": "right",
    "security.allowedUNCHosts": [
        "esprimoq956"
    ],
    "workbench.settings.applyToAllProfiles": [

    ]
}

解决步骤 #

核心原因 #

VSCode的git.path无法直接将相对路径解析为便携版的根目录，因为VSCode启动时的工作目录不一定是便携包的主目录，导致相对路径指向错误。

具体方案 #

1. 使用官方便携版VSCode的内置环境变量
   官方便携版VSCode会自动设置${env:VSCODE_PORTABLE}环境变量，指向便携包的根目录。直接修改git.path和GitBash路径为：

"git.path": "${env:VSCODE_PORTABLE}\\git\\bin\\git.exe",
// ...
"GitBash": {
  "path": ["${env:VSCODE_PORTABLE}\\git\\bin\\bash.exe"],
  "icon": "terminal-bash"
}

2. 非官方便携版的适配
   如果你的VSCode不是官方便携包，手动创建启动批处理文件code.bat放在VSCode主目录下，内容如下：

@echo off
set "VSCODE_PORTABLE=%~dp0"
start Code.exe

之后通过这个批处理启动VSCode，${env:VSCODE_PORTABLE}就会正确指向便携根目录。

3. 验证配置
   修改settings.json后重启VSCode，打开终端输入git --version，或在源代码管理面板执行Git操作，确认路径生效无错误。

修改后的完整配置 #

{
    "workbench.colorTheme": "Default Dark Modern",
    "git.ignoreMissingGitWarning": true,
    "git.enabled": true,
    "git.path": "${env:VSCODE_PORTABLE}\\git\\bin\\git.exe",
    "terminal.integrated.shellIntegration.enabled": true,
    "terminal.integrated.profiles.windows": {
      "PowerShell": { "source": "PowerShell", "icon": "terminal-powershell" },
      "Command Prompt": {
        "path": [
          "${env:windir}\\Sysnative\\cmd.exe",
          "${env:windir}\\System32\\cmd.exe"
        ],
        "icon": "terminal-cmd"
      },
      "GitBash": {
        "path": ["${env:VSCODE_PORTABLE}\\git\\bin\\bash.exe"],
        "icon": "terminal-bash"
      }
    },
    "terminal.integrated.defaultProfile.windows": "GitBash",
    "editor.fontSize": 18,
    "editor.tabSize": 2,
    "editor.mouseWheelZoom": true,
    "editor.showFoldingControls": "always",
    "workbench.iconTheme": "vscode-icons",
    "workbench.sideBar.location": "right",
    "security.allowedUNCHosts": [
        "esprimoq956"
    ],
    "workbench.settings.applyToAllProfiles": []
}

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