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>/$HOMEdoes 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
相关产品推荐
相关产品推荐

