remote-ssh 连接失败但 ssh 命令正常，主因是权限、配置路径、ssh agent 继承、shell 初始化及依赖缺失；需检查私钥权限（600）、config 中 identityfile 绝对路径、forwardagent、~/.bashrc 加载逻辑、$shell 正确性、tar/gzip 是否存在及 selinux 状态。
Remote-SSH 插件连不上，ssh 命令却能通，怎么回事？
VSCode 的 Remote-SSH 本质是调用本地 ssh 客户端，但它会严格读取 ~/.ssh/config 和密钥权限。常见错误是：本地终端能 ssh user@host，但 VSCode 报 Permission denied (publickey)。
- 确保私钥文件权限是
600（chmod 600 ~/.ssh/id_rsa），VSCode 不会忽略宽松权限 - 检查
~/.ssh/config中是否用了IdentityFile绝对路径；相对路径（如~/keys/id_rsa）在 VSCode 里可能被解析失败，换成/home/yourname/keys/id_rsa - 如果用了 SSH agent，VSCode 默认不继承终端的
SSH_AUTH_SOCK，要么在 VSCode 启动前运行code --no-sandbox（不推荐），要么在~/.ssh/config加ForwardAgent yes并确认 agent 已加载密钥
连接后打开的不是 Bash，而是 /bin/sh，环境变量和别名全失效
Remote-SSH 默认启动的是非登录、非交互式 shell，不会加载 ~/.bashrc 或 ~/.zshrc，所以 node、conda、alias ll 全都找不到。
- 在远程服务器上编辑
~/.bashrc，确保开头有if [ -n "$PS1" ]; then包裹别名和 PATH 扩展（很多发行版默认就有） - 更可靠的做法：在
~/.bash_profile或~/.profile末尾加一行：[[ -f ~/.bashrc ]] && source ~/.bashrc - 如果用 zsh，检查
~/.zprofile是否 source 了~/.zshrc；VSCode Remote 默认走$SHELL，但只读一次 login shell 配置
Failed to fetch remote environment 或卡在 “Setting up SSH Host”
这通常不是网络问题，而是远程服务器缺少基础依赖或 shell 初始化异常。
- 登录服务器后手动执行：
echo $SHELL，确认返回的是/bin/bash或/bin/zsh，不是/bin/false或/usr/sbin/nologin - 运行：
bash -ilc 'echo OK'（-i表示交互，-l表示登录），如果报错或无输出，说明 shell 配置有语法错误（比如~/.bashrc里某行少了个fi） - 检查远程是否安装了
tar和gzip：VSCode Remote 上传 server 二进制时依赖这两个命令，CentOS 最小化安装常缺gzip - 如果服务器启用了 SELinux，临时设为 permissive 模式测试：
sudo setenforce 0
文件保存慢、Git 操作卡顿、终端响应延迟高
这不是 VSCode 本身的问题，而是 Remote-SSH 的工作模式决定的：所有文件操作、Git 命令、终端输入，实际都在远程执行，但 UI 渲染在本地。网络延迟和磁盘 I/O 成为瓶颈。
- 关闭不必要的扩展：特别是那些“本地运行但扫描远程文件”的扩展（如某些 TODO 查找器、旧版 ESLint 插件），它们会在本地反复拉取远程文件列表
- 在远程服务器上把项目放在 SSD 分区，避免 NFS 或低速 NAS 路径
- Git 提交慢？改用远程终端执行
git commit，而不是依赖 VSCode 内置 Git UI；或者配置core.untrackedCache加速状态扫描 - 如果只是编辑文本，且网络不稳定，考虑用
scp+ 本地编辑 +rsync同步，比 Remote-SSH 更可控
远程开发真正难的不是连上，而是让远程 shell 行为和你预期一致——它不像本地终端那样“自动懂你”。每次配置变更后，务必在 VSCode 里重新打开一个 Remote 窗口验证，而不是复用旧连接。
