是，VSCode Remote-SSH 会读取 ~/.ssh/config，但仅当调用系统 ssh 命令且环境变量（尤其是 $HOME）与终端一致时生效；否则需手动配置 remote.ssh.configFile 或从终端启动。
VSCode Remote-SSH 是否读取 ~/.ssh/config？
是，但只在它调用系统 ssh 命令时才读取——而是否真能读到，取决于 VSCode 启动时的环境变量（尤其是 $HOME）是否与你在终端里一致。很多人配好了 ~/.ssh/config，却在 VSCode 里看不到主机列表，根本原因是：VSCode 桌面快捷方式启动时没加载 shell 配置，$HOME 指向错误路径，或 ssh 实际读的是另一个配置文件（比如 /etc/ssh/ssh_config）。
验证方法很简单：在 VSCode 内置终端里运行：
echo $HOME ssh -G myhost | grep -E "(user|hostname|identityfile)"
再对比你在 iTerm / Terminal / PowerShell 里执行相同命令的输出。如果不一致，就说明 VSCode 没拿到你预期的配置上下文。
解决办法只有两个：
- 从终端启动 VSCode：
code --remote ssh-remote+myhost或直接code（确保 shell 环境已加载） - 在 VSCode 设置里手动指定 SSH 配置路径：
remote.ssh.configFile，设为绝对路径如/Users/yourname/.ssh/config（macOS/Linux）或C:\Users\yourname\.ssh\config（Windows）
为什么 ProxyJump 和 ControlMaster 容易导致连接失败？
VSCode Remote-SSH 默认启用 ControlMaster auto（连接复用），而你手动在 ~/.ssh/config 里也写了 ControlMaster auto 或 ControlPath，就可能和 VSCode 自己管理的 socket 冲突——尤其当你同时用终端和 VSCode 连同一台机器时，会出现 “Connection refused” 或反复提示输入密码。
跳板机（ProxyJump）的问题更隐蔽：如果跳板机本身没开 ForwardAgent yes，或者你没把私钥加进 ssh-agent，那么通过跳板连目标服务器时会卡在认证环节，报错类似 Permission denied (publickey)，但错误日志里不提跳板机。
建议做法：
- 禁用 VSCode 的自动复用（避免干扰）：
"remote.ssh.enableDynamicForwarding": false - 跳板机配置中显式加上
ForwardAgent yes，并在本地运行ssh-add ~/.ssh/id_rsa_jump - 测试链路分步走：
ssh jump-host→ 成功后再试ssh -J jump-host target-host→ 最后让 VSCode 走同一命令
连接后看不到远程文件系统？先查 vscode-server 是否启动成功
VSCode 连上 SSH 后会在远程服务器自动部署 vscode-server，但它不是万能的。常见失败点有三个：
- 远程服务器无法访问微软更新源（如
update.code.visualstudio.com），导致下载卡住——表现为长时间停在 “Installing VS Code Server…” - 远程环境缺少基础依赖：
curl、wget、tar、unzip，或 glibc 版本太低（Alpine、某些容器镜像） -
~/.vscode-server目录权限问题，比如被 root 创建过，当前用户无写权限，报错Permission denied在 log 里
排查路径很直接：
打开远程服务器终端，检查日志：cat ~/.vscode-server/.cli.log 或具体 commit 日志如 ~/.vscode-server/.8b3775030ed1a69b13e4f4c628c612102e30a681.log；
手动验证部署环境：which curl && tar --version && ls -l ~/.vscode-server；
若确认是网络问题，可去 https://www.php.cn/link/eb7e87877c44af2443759ea1ef235358 找对应 commit 的 tar 包，上传后解压到 ~/.vscode-server/bin/<commit-id>。
多服务器同步代码该用 Remote-SSH 还是 SFTP 插件？
Remote-SSH 是开发态连接，适合单台主力服务器上的日常编码、调试、终端交互；它不负责“同步”，所有文件操作都是实时挂载式的，编辑即生效。
要一对多同步（比如改一个配置发到 5 台测试机），Remote-SSH 不适用——它一次只连一台，且没有批量上传机制。
这时应选 SFTP 插件（推荐 Natizyskunk 维护版），靠 sftp.json 定义多个 profile，并用 defaultProfile 或命令面板切换：
{
"name": "prod-cluster",
"profiles": {
"web01": { "host": "10.0.1.10", "username": "deploy", "remotePath": "/opt/app/" },
"web02": { "host": "10.0.1.11", "username": "deploy", "remotePath": "/opt/app/" }
},
"uploadOnSave": true,
"defaultProfile": "web01"
}
注意两点：
- SFTP 插件上传的是文件副本，不是实时挂载，所以修改远程文件不会自动反映回本地
- 它不处理 Git 状态或符号链接，大项目慎用全量同步，建议配合
ignore过滤掉node_modules、__pycache__等目录
真正复杂的多机协同场景（比如 CI 触发部署、灰度发布），VSCode 层面只能做轻量辅助；核心逻辑得靠 Ansible、rsync 脚本或专用部署平台来兜底。
