Remote SSH连接失败主因是SSH密钥配置错误或sshd配置限制；需手动用ssh -T验证、检查~/.ssh/config权限与IdentityFile设置、确认sshd_config中AllowTcpForwarding和PermitTunnel为yes、确保用户shell及PATH正确、排查磁盘空间与防火墙。
Remote SSH 能直接编辑服务器文件，但必须走 SSH 密钥认证，密码登录默认被禁用，连不上八成是密钥没配好或 sshd 配置拦住了。
Remote SSH 连接失败：检查 ssh -T 和 ~/.ssh/config
VSCode Remote SSH 本质是调用本地 ssh 命令，它不自己实现连接逻辑。所以先在终端手动验证能否连通：
- 运行
ssh -T user@host—— 如果提示Permission denied (publickey)，说明密钥没加载或服务端拒绝； - 检查
~/.ssh/config是否存在且权限为600（chmod 600 ~/.ssh/config），内容需明确指定IdentityFile，例如：Host myserver HostName 192.168.1.100 User ubuntu IdentityFile ~/.ssh/id_rsa_server - 确保私钥文件本身权限也是
600，否则 OpenSSH 会静默忽略； - Windows 用户注意：WSL 中的密钥路径不能直接给 VSCode Windows 版用，得用 Windows 原生
~/.ssh下的密钥。
VSCode 提示 “Could not establish connection to …”：看 remote-ssh 日志和 sshd 配置
这个错误不是 VSCode 的问题，而是远程 sshd 拒绝了 VSCode 启动的子进程（比如 vscode-server 安装或 shell 初始化）。常见原因：
-
/etc/ssh/sshd_config中设置了AllowTcpForwarding no或PermitTunnel no—— Remote SSH 依赖 TCP 转发，必须设为yes； - 用户 shell 不是
/bin/bash或/bin/sh（如zsh未正确配置~/.zshrc中的PATH）—— VSCode 启动时可能找不到bash或curl，导致vscode-server下载失败； - 服务器磁盘满或
/tmp不可写 ——vscode-server默认解压到~/.vscode-server，但初始化阶段会用/tmp； - 防火墙（如
ufw）拦截了除 22 外的临时端口 —— Remote SSH 会开随机高阶端口通信，建议关掉 ufw 或允许OpenSSH应用规则。
连接后打开文件慢、自动保存卡顿：调整 remote.SSH.showLoginTerminal 和禁用非必要插件
Remote SSH 不是“把本地 VSCode 搬过去”，而是在远端跑一个轻量 server，本地只渲染 UI。性能瓶颈常出在 IO 和插件同步上：
- 关闭
remote.SSH.showLoginTerminal（设为false），避免每次连接都弹出无用 terminal； - 远端不要安装图形类插件（如
GitLens、Bracket Pair Colorizer），它们会在服务端重复激活，拖慢启动； - 大项目建议在远端用
code --disable-extensions启动，再按需启用； - 如果频繁修改的是小文件，确认没有开启
files.autoSave设为afterDelay且延迟太短（如 500ms），网络抖动下会触发大量冗余保存请求。
真正麻烦的不是连不上，而是连上了却不知道哪个环节在阻塞 —— 日志藏在 VSCode 窗口左下角「Remote Explorer」面板里点「Show Log」，或者打开命令面板（Ctrl+Shift+P）运行 Remote-SSH: Show Log。别跳过这一步。
