remote-ssh插件v0.107.x最稳定兼容vs code≤1.102，v0.108.x要求≥1.103；版本不匹配会导致localforward配置被跳过、端口转发失效且无报错。
VSCode 插件更新后端口转发失效，大概率不是转发逻辑坏了，而是 Remote-SSH 或 Remote-Containers 插件版本与当前 VSCode 不兼容，导致配置加载失败、隧道未建立或转发规则被忽略。
Remote-SSH 插件版本不匹配导致 LocalForward 被跳过
VSCode 1.90+ 对扩展的 engines.vscode 字段校验变严，若 Remote-SSH 插件 package.json 声明只支持 "^1.89.0"，而你用的是 1.102.1，它会在启动阶段直接跳过加载——LocalForward 配置根本不会被读取，也不会报错。
- 检查插件实际版本：
code --list-extensions --show-versions | grep remote-ssh - 确认 Remote-SSH 兼容表：v0.107.x 仅支持 VSCode ≤1.102；v0.108.x 要求 ≥1.103
- 手动降级（如需）：去
https://github.com/microsoft/vscode-remote-release/releases下载匹配的.vsix，用code --install-extension安装 - 装完必须完全退出 VSCode（包括托盘进程），否则缓存仍用旧版逻辑
devcontainer.json 中 forwardPorts 不生效（Remote-Containers 场景）
更新后常见现象是容器已启动、forwardPorts: [3000] 也写了，但浏览器访问 localhost:3000 仍报 Connection refused——本质是 VSCode 端口转发 UI 启动了，但底层没把流量真正送到容器内服务。
- 确认容器内服务监听地址是
0.0.0.0:3000，不是127.0.0.1:3000（后者在容器网络中不可达） -
forwardPorts只触发 VSCode 的隧道转发，若需被本地其他工具（curl、Postman）访问，必须补runArgs："runArgs": ["--publish=3000:3000"] - Podman/Rancher Desktop 用户额外注意：
remote.containers.dockerSocketPath必须显式指向真实 socket（如/run/user/1000/podman/podman.sock），否则容器启动都失败，转发无从谈起
端口转发图标显示正常但连接失败
右下角状态栏看到绿色「Port forwarding」图标，不代表请求能通。它只说明 SSH 隧道建成了，但远程服务可能根本没在对应地址监听，或被防火墙拦截。
- 连上远程后，终端执行：
ss -tlnp | grep :3000，看第二列是否为127.0.0.1:3000、*:3000或[::1]:3000 - 常见框架（Vite、Next.js、create-react-app）默认只绑
::1（IPv6 localhost），得加--host 127.0.0.1或配server.host: '127.0.0.1' - 本地端口被占时，VSCode 会静默递增（如输 3000 却映射到 3001），务必点状态栏「Forwarded Ports」悬停查看真实绑定关系
- 服务器防火墙（如 ufw）需放行
127.0.0.1:3000—— 有些服务即使监听127.0.0.1，SSH 进程转发时仍受其限制
最易被忽略的一点：插件更新后，VSCode 可能沿用旧的 SSH 连接缓存，不重新加载 ~/.ssh/config 里的 LocalForward。断开连接后，必须彻底关闭 Remote-SSH 窗口（不只是 Reload Window），再重新 Connect to Host，否则新配置永远不会生效。
