You need to enable JavaScript to run this app. VS Code WSL Remote模式集成终端cwd配置失效、自动跳转安装目录问题
优惠活动
大模型
产品
解决方案
定价
更多

VS Code WSL Remote模式集成终端cwd配置失效、自动跳转安装目录问题

VS Code 集成终端默认工作目录异常问题

问题表现

  • 使用初期VS Code可正常让新打开的集成终端进入当前工作区目录
  • 开启配置同步后,旧版本Windows端的历史异常配置被同步带回,新终端启动时会自动跳转至VS Code的AppData安装路径,初始路径为:
    /mnt/c/Users/<user>/AppData/Local/Programs/Microsoft VS Code

已尝试操作与对应报错

  • 在设置面板的终端cwd配置项中填入$HOME或${HOME},终端启动失败,报错为:

The terminal process failed to launch: Starting directory (cwd) /home/<user>/${HOME} does not exist.
The terminal process failed to launch: Starting directory (cwd) /home/<user>/$HOME does not exist.

  • 清空cwd配置项的内容后,触发类型校验报错:

Setting has an invalid type, expect "string". Fix in JSON.

  • 目前临时将配置设置为"terminal.integrated.cwd": ".",规避路径跳转问题
  • 现有用户配置无其他特殊自定义改动,完整内容如下:
{
    "workbench.editorAssociations": [
        {
            "viewType": "jupyter.notebook.ipynb",
            "filenamePattern": "*.ipynb"
        }
    ],
    "git.autofetch": true,
    "workbench.colorTheme": "One Dark Pro",
    "python.languageServer": "Pylance",
    "terminal.integrated.scrollback": 10000,
    "terminal.integrated.tabs.enabled": true,
    "terminal.integrated.tabs.location": "left",
    "terminal.integrated.bellDuration": 10000,
    "terminal.integrated.cwd": "."
}

问题核心成因

  • 同步的旧配置携带硬编码的Windows端VS Code安装绝对路径,该路径在当前WSL/Linux环境下被VS Code直接识别为终端初始工作目录,导致终端启动后自动跳转至该安装路径。
  • terminal.integrated.cwd配置项不支持直接解析Shell风格的环境变量语法:VS Code会将用户填入的$HOME、${HOME}字符串直接作为路径片段,拼接默认用户目录生成不存在的无效路径,不会将变量语法传递给Shell做展开解析,因此触发启动报错。
  • 该配置项的类型校验逻辑要求字段值必须为字符串类型,空值不符合校验规则,因此会触发类型不匹配的报错。

对应解决方案

  • 恢复新终端默认进入当前工作区目录的行为:
    直接从配置文件中删除terminal.integrated.cwd配置项(注意是删除整个键值对,而非保留键后清空字符串值)。删除后VS Code会启用默认终端启动逻辑,优先进入当前打开的工作区根目录,不再加载同步残留的硬编码路径。
  • 若需要将终端初始目录固定设置为用户主目录,需使用VS Code内置的变量替换语法,将配置值写为${env:HOME},VS Code会在启动终端前自动读取对应环境变量完成路径解析,避免Shell变量语法被直接当字符串拼接的问题。
  • 排查同步配置残留:
    进入设置面板搜索terminal.integrated.cwd,确认界面展示的配置值没有被同步的旧Windows安装路径覆盖;若发现残留的旧路径值,直接删除该配置字段即可。

内容的提问来源于stack exchange,提问作者scotttyso

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.22 08:24:02