Remote-SSH插件安装后不能直接连接，需确保本地SSH客户端可用、服务器sshd运行、防火墙放行22端口、认证方式有效，并正确配置~/.ssh/config中的HostName、User、Port和IdentityFile。
Remote-SSH 插件装完就等于能连上？
不是。装了 Remote-SSH 插件只是第一步，真正连接前必须确保本地 SSH 客户端可用、服务器 SSH 服务已启用、且密钥或密码认证通路畅通。Windows 用户若没装 OpenSSH Client（Win10 1809+ 默认带，但可能被禁用），会卡在“Resolving host…”不动；macOS 和 Linux 一般自带，但需确认 ssh -V 能正常输出版本。
- 检查本地 SSH：运行
ssh -T git@github.com，能返回成功提示说明基础环境 OK - 服务器端确认
sshd正在运行：sudo systemctl is-active sshd（Ubuntu/CentOS 7+） - 防火墙要放行 22 端口（或自定义端口），
ufw allow 22或firewall-cmd --add-port=22/tcp --permanent - 首次连接建议用密码登录一次，让 VSCode 自动把公钥追加到服务器的
~/.ssh/authorized_keys
配置 SSH Host 时路径和用户写错会导致反复重连失败
VSCode 的 Remote-SSH 依赖 ~/.ssh/config 或内置连接字符串。常见错误是把 HostName 写成内网 IP 却从外网连，或漏写 User 导致默认用当前本地用户名（而服务器上不存在该用户）。如果服务器改过 SSH 端口，必须显式指定 Port，否则永远走 22。
- 推荐在
~/.ssh/config中写明配置，例如：
Host myserver
HostName 192.168.1.100
User ubuntu
Port 2222
IdentityFile ~/.ssh/id_rsa_server
- 在 VSCode 命令面板（
Ctrl+Shift+P）中选Remote-SSH: Connect to Host...，再选myserver，别手输连接串 - 如果用密码登录，确保服务器
/etc/ssh/sshd_config中PasswordAuthentication yes已启用并重载服务：sudo systemctl restart sshd
远程窗口里打开的终端默认不是 Bash，PATH 和别名都失效
VSCode 远程连接后新建的集成终端，默认 shell 是 /bin/sh（尤其在 Ubuntu Server 等最小化安装系统上），导致你配置的 ~/.bashrc 不加载、conda 命令找不到、甚至 ll 别名报错。这不是 VSCode bug，是远程系统本身的 shell 行为。
- 在远程窗口中打开命令面板，执行
Terminal: Select Default Profile，选bash或zsh（取决于你服务器实际 shell） - 更彻底的解决：在远程服务器上执行
chsh -s $(which bash)把登录 shell 改为 bash - 如果仍不生效，检查 VSCode 设置里的
terminal.integrated.defaultProfile.linux是否被覆盖为sh
文件保存慢、Git 操作卡顿，大概率是扩展同步出了问题
VSCode 默认会把部分扩展（尤其是语言服务类）同步到远程服务器运行，但如果扩展本身不支持远程、或远程环境缺依赖（比如没装 node、python3），就会反复尝试启动失败，拖慢整个编辑器响应。Git 提交变慢常是因为 GitLens 或 ESLint 在远程扫描超大 node_modules 目录。
- 右键点击左下角远程连接状态栏 →
Remote Extension Recommendations，只启用真正需要的远程扩展（如Python、Pylance） - 把
files.exclude和search.exclude加上**/node_modules、**/__pycache__等目录 - 禁用非必要本地扩展的远程同步：在扩展详情页点齿轮图标 →
Extension Settings→ 关掉Remote: Extension Kind中的workspace
~/.bashrc、Git 图标不刷新、或者保存文件等三秒才响应。这些问题几乎都藏在 SSH 配置、shell 初始化逻辑、或扩展同步策略里，而不是 VSCode 界面按钮上。 
