remote-ssh连通不等于功能正常，需确认三件事：本地ssh-v有效、远程有curl/wget且~/.vscode-server可写；~/.ssh/config常见错误包括hostname解析失败、identityfile路径含空格或反斜杠、冗余port字段；终端不加载bash/zsh因非交互式shell未source配置，应加remotecommand bash -i或在~/.bash_profile中追加source ~/.bashrc。
能连上，不代表能稳定用；能打开文件夹，不代表插件、终端、调试全正常。Remote-SSH 的核心问题不是“怎么连”，而是“连上之后哪些东西会悄悄失效”。
Remote-SSH 插件安装后必须确认的三件事
装完 Remote - SSH 插件不能直接开干，它依赖本地 SSH 客户端和远程服务器的最小运行环境：
- 本地终端执行
ssh -V，确保输出类似OpenSSH_9.6p1, OpenSSL 3.0.13—— 没这行，VS Code 后续所有连接都会卡在“Setting up SSH Host” - 远程服务器必须有
curl或wget（VS Code Server 下载阶段要用），执行which curl看是否返回路径 - 远程用户主目录下要有写权限的
~/.vscode-server，否则首次连接时解压失败，错误提示是Failed to install inotifywait或直接静默退出
SSH 配置文件里最容易写错的参数
~/.ssh/config 不是越复杂越好，多数连接失败源于这几处硬编码陷阱：
-
HostName写成域名但 DNS 不通？换成 IP 更可靠，尤其内网开发时 -
IdentityFile路径含空格或中文？Windows 上写成C:/Users/xxx/.ssh/id_rsa（正斜杠），别用反斜杠 -
Port显式写了22？其实可删——除非你改过服务端口，否则多余字段反而干扰解析 - 漏掉
ForwardAgent yes？某些需要跳板机或访问 GitHub 私库的场景会报Permission denied (publickey)，加了才转发本地 agent
连接成功但终端不加载 bash/zsh 的真实原因
左下角绿色圆点亮了，Ctrl + ~ 打开终端却还是 /bin/sh，命令补全、历史记录全失效——这不是 VS Code 问题，是远程 shell 初始化没触发：
- 检查远程服务器上
~/.bashrc或~/.zshrc是否有return提前退出（常见于某些云镜像） - VS Code 默认调用的是非交互式 shell，不会自动 source
~/.bashrc，得在配置里显式指定：
在~/.ssh/config对应 Host 下加一行：RemoteCommand bash -i - 更稳妥的做法：在远程服务器的
~/.bash_profile末尾追加source ~/.bashrc，确保登录 shell 加载完整环境
插件在远程端不生效的隐藏开关
你在本地装了 Python、Prettier、ESLint，连接后编辑 Python 文件却没语法高亮、没格式化——因为这些插件默认只装在本地：
- 右键远程资源管理器里的主机名 →
Install Local Extension on SSH: xxx，手动把关键插件推过去 - 或者打开设置，搜
remote.extensionKind，添加规则："ms-python.python": ["workspace"]，强制该插件在远程运行 - 注意：不是所有插件都支持远程运行，比如 Live Server 这类依赖本地浏览器的，必须关掉，否则反复报错
Cannot start server
真正卡住人的从来不是第一次连接，而是某天突然发现 Git 图标没了、终端颜色变灰、调试器断点不命中——这些问题几乎都出在远程 ~/.vscode-server 目录的版本残留或权限错乱上。定期清理 rm -rf ~/.vscode-server（再重连触发重装），比查日志快得多。
