VSCode集成终端默认不复用Remote-SSH连接，需手动创建新终端（Ctrl+Shift+P → Terminal: Create New Terminal）才能运行在远程上下文；根本原因是remote.SSH.useLocalServer默认为false且终端不继承认证状态，必须通过配置强制绑定。
VSCode集成终端不自动继承Remote-SSH连接？
VSCode的集成终端默认不会复用Remote-SSH建立的连接通道，而是新开一个独立SSH会话——这意味着你可能在编辑器里连着远程主机，但终端里却卡在本地shell，或者弹出重复密码提示。
根本原因是：remote.SSH.useLocalServer 默认为 false，且终端未被明确绑定到当前远程会话上下文。它不读取Remote-SSH已协商好的认证状态或代理配置。
- 确认当前是否处于Remote-SSH会话：右下角状态栏应显示类似
SSH: your-host的标识；若只显示本地路径，则终端必然运行在本地 - 手动触发远程终端：按
Ctrl+Shift+P→ 输入Terminal: Create New Terminal，此时新终端会自动运行在远程环境（前提是Remote-SSH连接已激活） - 避免误操作：不要在未连接Remote-SSH时点击“+”新建终端，否则创建的是本地终端，后续即使连上Remote-SSH也不会自动迁移
如何让集成终端始终运行在远程SSH上下文中？
关键不是“自动连接”，而是“自动绑定”——VSCode本身不提供终端自动重连SSH的功能，但可通过配置强制终端生命周期与Remote-SSH对齐。
- 启用
remote.SSH.useLocalServer：设为true，让VSCode复用本地SSH agent和密钥缓存，减少终端启动时的认证延迟 - 禁用终端自动恢复：关闭
terminal.integrated.enablePersistentSessions，防止断开Remote-SSH后终端仍试图维持旧会话（这常导致ssh: connect to host ... port 22: Connection refused错误） - 设置默认终端为远程：在远程工作区的
.vscode/settings.json中添加"terminal.integrated.defaultProfile.linux": "bash"（Linux远程）或"terminal.integrated.defaultProfile.windows": "PowerShell"（Windows远程），避免终端意外回退到本地profile
终端卡在“Connecting to SSH Host…”不动？
这不是连接超时，而是VSCode尝试用当前终端复用Remote-SSH通道失败后，转而自行发起SSH连接——但它没拿到正确的Host别名或参数，于是卡住。
常见诱因：
-
~/.ssh/config中对应Host块缺失HostName或拼写错误（比如写成hostname小写） - 私钥权限过宽：远程终端执行
ssh命令时拒绝加载IdentityFile，报错Permissions 0644 for 'xxx' are too open，需运行chmod 600 ~/.ssh/id_rsa - 终端启动时未加载shell profile：某些集群环境依赖
~/.bashrc设置PATH或代理，而VSCode终端默认不source它，可加"terminal.integrated.shellArgs.linux": ["-l"]强制登录shell模式
为什么改了~/.ssh/config终端还是连不上？
VSCode集成终端不直接读取 ~/.ssh/config 的全部逻辑——它只识别首个匹配的 Host 块，且忽略注释后空行、缩进异常等格式问题。更隐蔽的问题是：它不支持 Include 指令（OpenSSH 7.3+特性），也不解析条件判断（如 Match host）。
- 验证配置是否生效：在VSCode集成终端中运行
ssh -F ~/.ssh/config -o ConnectTimeout=5 -v your-host，观察debug输出里实际使用的HostName和IdentityFile - 避免嵌套引用：不要在
~/.ssh/config中用Include引入其他文件，VSCode终端无法解析，必须把所有参数平铺写在同一个Host块内 - 注意路径分隔符：Windows用户若用WSL路径，
IdentityFile必须用Linux风格路径（如/home/user/.ssh/id_rsa），而非C:\Users\...
最易被忽略的一点：VSCode集成终端的SSH行为完全取决于它启动时的上下文，而不是你当前打开的文件路径或工作区设置。一旦Remote-SSH连接断开，所有已打开的远程终端会立即失效，但界面不会自动关闭——它们变成“僵尸终端”，输入任何命令都无响应，必须手动关闭并重建。
