VS Code Remote-SSH 预连接脚本（remote.SSH.preconnect）与 Remote Explorer 折叠改进详解-北京尧图网络

文档教程【免费下载链接】vscode-docsPublic documentation for Visual Studio Code项目地址https://gitcode.com/gh_mirrors/vs/vscode-docs点击查看免费下载导读VS Code 1.1012025 年 5 月为 Remote Development 扩展带来两项 SSH 相关改进全新的remote.SSH.preconnect预连接脚本设置以及 Remote Explorer 对 SSH 主机的自动折叠显示。本文以 remote-release-notes/v1_101.md 为主体结合 docs/remote/ssh.md 等仓库文档详解预连接脚本的两种配置形态、平台差异、输出与安全机制以及折叠行为的配置方法帮助你自动化 SSH 连接前的准备流程并优化多主机场景下的视图管理。版本背景1.101 中的 Remote Development 更新在 release-notes/v1_101.md 的 Remote Development 章节中官方将本次发布的高亮特性概括为两项SSH pre-connection scriptSSH 预连接脚本Remote Explorer improvementsRemote Explorer 改进这两项能力都属于 Remote - SSH 扩展的范畴。Remote - SSH 允许你在任何运行着 SSH 服务器的远程机器、虚拟机或容器上打开远程文件夹并在本地获得完整的开发体验扩展会在远程系统上安装 VS Code Server本地无需存放源码参见 docs/remote/ssh.md 的开篇说明。预连接脚本与折叠视图正是在这一架构之上新增的连接生命周期与视图管理能力。预连接脚本在 SSH 连接建立之前执行准备任务解决的问题remote.SSH.preconnect设置允许你指定一段脚本在扩展真正建立 SSH 连接之前运行。官方给出的典型自动化场景包括证书续期Certificate renewal在连接前刷新即将过期的凭据避免连接时因凭据失效而失败认证准备Authentication setup预置认证材料或完成一次性登录流程环境校验Environment validation确认远程主机满足连接前提例如 SSH 服务可用、依赖工具Bash、tar、curl/wget齐备。从实现时序上看这段脚本位于用户发起连接与扩展执行ssh握手之间脚本先执行完毕扩展随后才发起真正的 SSH 连接。两种配置形态remote.SSH.preconnect支持两种配置方式在settings.json中分别体现为字符串与对象1. 单字符串对所有主机使用同一脚本{ remote.SSH.preconnect: /path/to/preconnect.sh }当所有 SSH 主机面临相同的准备需求例如统一的环境校验时用这种方式最简洁。2. 对象按主机分别配置{ remote.SSH.preconnect: { dev-server-01: /path/to/dev-preconnect.sh, prod-bastion: /path/to/prod-preconnect.sh } }从配置结构可以推断对象的键对应主机标识SSH config 中的 Host 别名或完整 FQDN值为该主机专用的脚本路径。当不同主机有不同的认证或网络前提时用对象形态为每台主机指定独立脚本。平台差异PowerShell 与 Shell 脚本脚本的语言取决于发起连接的本机平台Windows提供 PowerShell 脚本.ps1macOS / Linux提供可执行的 Shell 脚本.sh。需要确保脚本文件具有可执行权限macOS/Linux 下并在本地提前测试脚本可以独立运行成功再接入预连接流程。输出与安全机制脚本输出可见脚本运行时的输出会显示在Output 面板的Remote - SSH频道中。这与连接过程中扩展自身日志的输出位置一致docs/remote/ssh.md 中提到连接时可在Remote - SSHoutput channel 查看详细日志便于你在准备阶段排障。内容修改需批准每当脚本内容被修改VS Code 会要求用户批准后才允许其继续执行。这是一项安全防护预连接脚本在本机以你的用户身份运行若内容被意外篡改或来自不受信任的来源批准机制能阻止脚本在未确认的情况下执行。实战示例通过 Azure Bastion 与 AAD 认证连接 SSH原发布说明引用了一个真实用例利用预连接脚本完成Azure Bastion Azure Active DirectoryAAD的认证流程。在该场景下直接使用ssh连接经过 Bastion 的主机需要先完成 AAD 登录借助预连接脚本可以在 VS Code 尝试 SSH 连接之前自动处理认证流程例如刷新令牌、建立 Bastion 通道所需的前置握手从而让后续连接命令直接可用。该案例的核心思路是把认证前置工作从人工操作迁移到脚本中值得参考的实现要点是在脚本中完成 AAD 登录与令牌获取可复用azCLI 等工具将脚本路径配置到remote.SSH.preconnect在 Output 面板的 Remote - SSH 频道验证脚本输出是否符合预期若脚本需要迭代注意修改后需经过批准流程再重新触发连接。Remote Explorer 改进自动折叠 SSH 主机功能描述Remote Explorer 视图现在支持自动将 SSH 主机以折叠collapsed状态展示。此前视图会默认展开主机及其下的最近打开文件夹当用户拥有大量 SSH 主机例如数十台开发/测试服务器时展开的列表会占据大量视图空间难以快速定位目标主机。这一行为通过remote-explorer.collapseRecentFolders设置控制{ remote-explorer.collapseRecentFolders: true }适用场景与搭配设置适合主机数量多、每台主机的最近文件夹列表长的使用者开启后Remote Explorer 仅展示主机节点需要时再手动展开查看该主机的最近文件夹配合Open Folder图标直接打开参见 docs/remote/ssh.md 中对 SSH Targets 与展开操作的说明若希望进一步控制主机下的文件夹排序可搭配早期版本引入的remote.SSH.foldersSortOrder设置见 remote-release-notes/v1_62.md按字母序或最近打开时间排序。结合仓库文档的运维建议围绕上述两项功能docs/remote/troubleshooting.md 提供了可配合使用的排查思路查看连接日志连接异常时优先检查 Output 面板的 Remote - SSH 频道——预连接脚本的输出同样汇入该频道可据此区分是脚本失败还是连接本身失败确认远程主机前提Linux 主机需要 Bash、tar、curl或wget内核与 glibc 版本有最低要求参见 docs/remote/troubleshooting.md 的依赖说明环境校验类预连接脚本可以提前发现这类不满足项平台识别若远程为 Windows 主机需确保通过remote.SSH.remotePlatform正确声明docs/remote/troubleshooting.md 中有示例配置预连接脚本也应按本机平台分别编写。总结VS Code 1.101 的 SSH 预连接脚本与 Remote Explorer 折叠改进分别从连接前准备和视图信息密度两个角度提升了多主机远程开发体验remote.SSH.preconnect支持全局字符串与按主机对象两种配置覆盖证书续期、认证准备、环境校验等自动化场景输出进入 Remote - SSH 频道且脚本内容变更需用户批准remote-explorer.collapseRecentFolders让 SSH 主机默认折叠显示解决主机数量庞大时的视图拥挤问题。如需完整了解 Remote - SSH 的安装、连接、端口转发与故障排查可继续阅读 docs/remote/ssh.md 与 docs/remote/troubleshooting.md后续版本对 SSH 连接生命周期的更多能力如连接宽限期见 remote-release-notes/v1_107.md。赞分享文档教程【免费下载链接】vscode-docsPublic documentation for Visual Studio Code项目地址https://gitcode.com/gh_mirrors/vs/vscode-docs点击查看免费下载相关推荐OpenCore Legacy Patcher终极指南4步解决老Mac显卡驱动与系统升级问题OpenCore Legacy Patcher终极指南4步解决老Mac显卡驱动与系统升级问题 OpenCore Legacy PatcherOCLP是一款操作系统固件驱动开发VS Code Remote Development FAQ 全面解读SSH、Dev Containers 与 WSL 远程开发原理、连接与常见问题VS Code Remote Development FAQ 全面解读SSH、Dev Containers 与 WSL 远程开发原理、连接与常见问题本文以文档教程VibeThinker-3B新一代轻量级AI模型如何重塑代码与数学推理体验VibeThinker 3B新一代轻量级AI模型如何重塑代码与数学推理体验在人工智能快速发展的今天 VibeThinker 3B 作为一款创新的轻量级AI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

VS Code Remote-SSH 预连接脚本（remote.SSH.preconnect）与 Remote Explorer 折叠改进详解

相关推荐

云迁移回归测试标准化：从假绿到可信的测试体系搭建指南

从移位到异或：彻底搞懂二进制位运算的工程实战

VS2010集成OpenCV与zxing-cpp：工业视觉扫码实战与避坑指南

更多资讯

Python机器学习光伏功率预测实战：LightGBM时序建模与在线部署

skynet游戏服务器数据层实战：MySQL与Redis接入与避坑指南

SimpleUI屏幕引擎源码解读：如何把16个模块渲染进一块电纸屏

反诈视频宣传系统毕业设计：Spring Boot+Vue前后端分离开发指南

仿古铝瓦承京韵，匠筑亭台恒久颜

卡尺标定法径向扫描拟合圆V2.0：精密测量新思路

今日更新

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？