VS Code Remote SSH 怎样让新终端默认进入指定目录
在 VS Code 里通过 Remote - SSH 打开远程文件夹后,Terminal > New Terminal 创建的终端会运行在远程主机上。默认情况下,它会从资源管理器当前打开的文件夹开始;如果希望每次都进入一个固定的远程项目目录,可以配置 terminal.integrated.cwd。
官方地址:https://code.visualstudio.com/docs/remote/ssh
最稳妥的做法是:先确认左下角处于 Remote SSH 窗口,再打开 Remote Settings 或 Workspace Settings,把目录写成远程主机上的绝对路径,保存后关闭旧终端并重新创建。这样既不会把本地路径误写进去,也能避免只改 User Settings 却被项目设置覆盖。
一、先确认新终端真的连接到远程主机
Remote - SSH 的关键点是“窗口上下文”改变了:连接成功后,VS Code Server 和大多数工作区扩展运行在 SSH 主机上,新建终端也应当运行在这台远程主机上。不要在本地窗口里先配置路径,再期待它自动影响远程窗口。
- 用命令面板执行
Remote-SSH: Connect to Host...,选择目标主机。 - 在远程窗口中打开远程项目文件夹,而不是只打开一个本地文件。
- 执行
Terminal: Create New Terminal,观察终端使用的主机环境。
如果左下角仍显示本地窗口标识,先切换到正确的 Remote SSH 窗口。路径设置属于当前窗口上下文,窗口错了,后面所有排查都会偏离。
二、用 terminal.integrated.cwd 指定远程终端目录
VS Code 官方终端文档把 terminal.integrated.cwd 定义为终端的自定义起始路径。连接远程主机后,这个路径应当是远程主机能访问的路径,例如 /srv/workspace/orders;不要填写当前 Mac 或 Windows 上的本地目录。
打开命令面板,执行 Preferences: Open Remote Settings (JSON),加入下面的设置。JSON 设置文件必须保持合法格式,因此不在代码块里插入注释;字段含义放在代码块后说明。
{
"terminal.integrated.cwd": "/srv/workspace/orders"
}
这里的 terminal.integrated.cwd 是设置名,值是远程项目的绝对路径。路径可以是远程工作区根目录,也可以是它下面的固定子目录。保存后,新建的终端会把这个目录作为起始工作目录。

三、Remote Settings 和 Workspace Settings 怎么选
VS Code 在远程 SSH 窗口中允许使用主机专属设置。可以把设置写到 Remote Settings,让同一台远程主机上的多个工作区都采用相同起始目录;也可以写到 Workspace Settings,只影响当前项目。
| 设置位置 | 适用场景 | 优先考虑 |
|---|---|---|
| Remote Settings | 同一台 SSH 主机上的多个窗口都要遵循统一目录规则 | 个人远程开发机、固定目录布局 |
| Workspace Settings | 只有当前仓库需要固定到某个子目录 | 项目级约定、团队共享配置 |
| User Settings | 本地窗口和远程窗口都想使用同一个通用默认值 | 通用偏好,不适合写死远程专属路径 |
如果多个层级都设置了同一个键,优先检查当前窗口显示的 Remote、Workspace 和 User 设置。不要只看设置文件是否保存,要确认实际生效的值来自哪个作用域。
四、多根工作区和拆分终端的两个边界
如果一个窗口包含多个根文件夹,资源管理器默认目录可能取决于当前活动根目录;而显式的 terminal.integrated.cwd 会把新终端导向固定路径。需要按项目根目录切换时,不要把固定 cwd 和活动根目录逻辑混用。
拆分终端还要单独看继承规则:在 macOS 和 Linux 上,拆分终端通常继承父终端当前工作目录;如果希望拆分终端回到工作区根目录,可以设置 terminal.integrated.splitCwd:
{
"terminal.integrated.cwd": "/srv/workspace/orders",
"terminal.integrated.splitCwd": "workspaceRoot"
}
第一项控制新建终端的固定起点,第二项控制拆分终端的起点。它们解决的是不同动作,不要只修改 splitCwd 来修复“点击 New Terminal 目录不对”。
五、设置保存后仍不生效,按这条顺序排查
- 确认窗口:检查当前窗口是否真的是 Remote SSH,且打开的是目标远程文件夹。
- 确认作用域:在设置编辑器里搜索
@modified terminal.integrated,查看 Remote、Workspace、User 是否存在互相覆盖的值。 - 确认远程路径:目录必须存在、确实是目录,并且当前远程账号有访问权限;本地磁盘上的同名路径没有意义。
- 关闭旧终端:已经打开的终端不会因为设置保存就自动切换目录,关闭它后再执行 New Terminal。
- 区分拆分动作:如果只在 Split Terminal 时不对,继续查看
terminal.integrated.splitCwd以及父终端的当前目录。

终端启动失败时,官方排查建议还包括检查起始目录是否存在、是否可访问,以及所选终端配置是否指向已安装的 Shell。远程终端要按远程主机的平台检查,例如远程是 Linux,就不能拿本地 macOS 的路径和权限判断。
六、一个可复用的配置思路
如果你维护多个远程项目,可以把“主机级默认目录”和“项目级例外”分开:Remote Settings 放一个远程主机通用的目录,特定仓库再用 Workspace Settings 覆盖;不要把个人电脑路径提交到仓库,也不要为了一个项目修改全局 User Settings。
{
"terminal.integrated.cwd": "/srv/workspace/orders",
"terminal.integrated.splitCwd": "inherited"
}
上面的配置把新建终端固定在订单项目目录,同时让拆分终端沿用父终端位置。若团队希望拆分终端始终回到项目根目录,把第二项改成 workspaceRoot,并在项目说明里写清楚这个选择。
总结
VS Code Remote SSH 新终端默认目录不对时,核心不是重新登录 SSH,而是确认窗口上下文和设置作用域。先在远程窗口配置 terminal.integrated.cwd,再根据需要选择 Remote 或 Workspace Settings;遇到拆分终端差异时检查 terminal.integrated.splitCwd,最后关闭旧终端重新创建。
常见问题
为什么配置了本地路径,远程终端还是打不开?
因为 Remote SSH 终端解析的是远程主机文件系统。本地路径即使存在,也不代表远程账号能访问;应改成远程主机上的绝对路径。
只想影响当前项目,应该改哪一层?
优先使用 Workspace Settings。这样不会改变同一台 SSH 主机上其他项目的新终端目录。
设置保存后,当前终端为什么没有移动?
cwd 是终端创建时的起始目录。关闭当前终端并重新执行 New Terminal,才会观察到新设置。
Split Terminal 和 New Terminal 为什么目录不同?
它们遵循的设置不同:新建终端看 terminal.integrated.cwd,拆分终端还会受到 terminal.integrated.splitCwd 和父终端当前目录影响。
Redis XCLAIM IDLE 怎样重置待处理消息的空闲时间
- 上一篇
- Redis XCLAIM IDLE 怎样重置待处理消息的空闲时间
- 下一篇
- Audacity 怎样把波形纵轴切换为分贝刻度
-
- 文章 · 软件教程 | 1天前 | 故障排查 · 软件教程 · 快捷键 Intellij IDEA 导出设置 导入设置 JetBrains IDE Keymap
- JetBrains IDE 怎样导出并迁移自定义快捷键
- 322浏览 收藏
-
- 文章 · 软件教程 | 1天前 |
- Docker 构建怎样安排层顺序提高缓存命中
- 332浏览 收藏
-
- 文章 · 软件教程 | 1天前 | css · vs code · CSS VS Code 颜色预览 editor.colorDecorators
- VS Code 怎样只关闭 CSS 文件中的颜色预览方块
- 100浏览 收藏
-
- 文章 · 软件教程 | 1天前 |
- GitHub Actions 怎样上传并保留构建产物
- 296浏览 收藏
-
- 文章 · 软件教程 | 1天前 | 开发环境 · vs code · VS Code uid GID devcontainer.json Dev Containers remoteUser containerUser
- VS Code Dev Containers 怎样避免容器内文件变成 root
- 258浏览 收藏
-
- 文章 · 软件教程 | 1天前 | vs code · 软件教程 · 编辑器 VS Code 代码折叠 Fold Level
- VS Code 怎样用折叠级别快速收起嵌套代码
- 152浏览 收藏
-
- 文章 · 软件教程 | 1天前 | vs code · 软件教程 · VS Code tasks.json 任务变量 inputs
- VS Code 任务怎样用输入变量减少重复命令
- 368浏览 收藏
-
- 文章 · 软件教程 | 1天前 | 开发工具 · vs code · 软件教程 · VS Code settings.json Workspace settings Settings editor 设置优先级
- VS Code 设置优先级怎样定位项目配置被用户设置覆盖
- 327浏览 收藏
-
- 文章 · 软件教程 | 1天前 | Node.js · vs code · VS Code launch.json 多环境 调试配置
- VS Code launch.json 怎样给多环境复用调试配置
- 211浏览 收藏
-
- 文章 · 软件教程 | 2天前 |
- Docker Compose检查端口与网络解析
- 338浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1083次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1084次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1246次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1191次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1036次使用
-
- VS Code Dev Containers 实战:用容器搭建一致开发环境
- 2026-06-12 182浏览
-
- Docker Compose 本地多服务环境实战:MySQL、Redis、Nginx 一键启动
- 2026-06-12 250浏览
-
- Git worktree 实战:一套仓库并行修 Bug 和开发新功能
- 2026-06-12 447浏览
-
- Nginx 本地 HTTPS 反向代理实战:前后端联调不再改端口
- 2026-06-12 373浏览
-
- Chrome DevTools Network 面板实战:定位接口慢、缓存和请求失败
- 2026-06-13 213浏览

