Remote-SSH 连不上因插件未在远程安装，需手动执行“Install to Host”；SSH 配置应基于 OpenSSH 的 ~/.ssh/config，用 Host 别名和 Include 管理多主机；图标变灰常见于配置错误或环境变量未加载；文件监视卡顿需在远程 .vscode/settings.json 中正确设置 files.watcherExclude。
远程连接时插件没加载，Remote - SSH 为什么连不上目标主机
VSCode 的远程功能不是靠“插件自动生效”，而是由 Remote - SSH 插件接管整个窗口生命周期。一旦你用它连接成功，本地已安装的插件默认不会同步到远程——除非你明确设置为“在远程安装”。常见现象是：本地能跑 Python、ESLint 正常，一连远程就报 Command 'python.interpreterPath' not found 或格式化直接失效。
- 检查左下角状态栏是否显示
SSH: user@host，没显示说明根本没进远程会话，只是本地打开文件夹 - 右键命令面板（
Ctrl+Shift+P），搜Remote-SSH: Install to Host，选中当前连接的服务器手动安装核心插件 -
settings.json里别写"extensions.autoInstall": true，这仅对本地有效；远程插件需单独配置"remote.extensionKind"或在远程的.vscode/extensions.json中声明 - 某些插件（如
GitLens）在远程模式下会降级功能，因为 Git 操作实际走的是远程 shell，不是本地 Git 客户端
多个服务器之间快速切换，config 文件怎么组织才不混乱
VSCode 读取的是 OpenSSH 的 ~/.ssh/config，不是自己维护一套配置。很多人手动输 host、user、port，结果每次换机器都要重配，还容易漏掉 IdentityFile 或 ForwardAgent yes 这类关键项。
- 每个服务器块必须以
Host alias-name开头，别用 IP 直接当 Host 名——否则 VSCode 的连接列表里全是192.168.1.100，根本分不清哪台是测试库哪台是预发 - 复用配置用
Include：比如把通用段（ServerAliveInterval、IdentitiesOnly yes）抽到~/.ssh/common.conf，再在各主机块里写Include common.conf - 避免嵌套
Host *全局匹配，它会污染所有后续 Host 块的参数；真要全局设，放文件最顶部且用Match all更可控 - 路径中的波浪号
~在 VSCode 里可能不展开，IdentityFile ~/.ssh/id_rsa建议写成绝对路径/home/user/.ssh/id_rsa
Remote Explorer 面板里服务器图标变灰，点不动怎么办
图标变灰 = VSCode 认为该 Host 当前不可达，但原因不一定是网络不通。更常见的是 SSH 配置语法错误、密钥权限不对、或远程 sshd 没开 PermitUserEnvironment yes 导致环境变量加载失败，进而影响 VSCode 启动服务端进程。
- 终端里手动执行
ssh -F ~/.ssh/config alias-name -v，看最后几行有没有debug1: Sending command: /bin/sh -c 'cd ... && $SHELL -l -c ...'—— 如果卡在 authentication 或直接退出，问题不在 VSCode - 检查远程服务器的
/etc/ssh/sshd_config是否禁用了AllowTcpForwarding（VSCode 需要它做端口代理） - Ubuntu 22.04+ 默认禁用
~/.profile里的环境变量，而 VSCode 的远程服务端依赖$PATH找node，记得在~/.bashrc末尾加export PATH=$HOME/.nvm/versions/node/v18.17.0/bin:$PATH并确保~/.bashrc被加载 - 别在
~/.ssh/config里用ProxyJump指向一个没装openssh-client的跳板机——VSCode 不会帮你装，它只调用本地ssh命令
远程开发时 CPU 占用高、文件监视卡顿，files.watcherExclude 怎么设才有效
VSCode 默认用 chokidar 监听远程文件系统，但 NFS、CIFS 或慢速磁盘上，递归监听 node_modules 或 dist 会导致大量 inotify 事件堆积，SSH 通道持续满载，编辑器假死。
- 排除规则必须写在远程工作区的
.vscode/settings.json里，本地设置无效；路径是相对于远程工作目录的，不是本地 - 用 glob 模式，别写正则：
"**/node_modules/**"、"**/*.log"、"**/build/**"，注意结尾的/**表示递归子目录 - 如果项目用
pnpm，还得加"**/.pnpm/**"，它不像 npm 那样把依赖平铺在node_modules里 - 设完后重启远程窗口（
Remote-SSH: Reopen Folder in Remote），单纯重载不行，因为 watcher 进程是启动时初始化的
真正麻烦的是跨平台路径处理和环境变量链路——比如你在 macOS 上连 Linux 服务器，~ 展开逻辑不同；或者远程 PATH 里没包含 python3，但插件硬编码调用 python，这种细节不报错，只默默失效。
