必须先安装Remote-SSH插件，它是远程开发的基础设施；未安装则左下角无<>图标、命令面板无Remote-SSH命令，所有后续配置均无法进行。
Remote-SSH 插件必须先装好
没装 Remote-SSH，后续所有操作都卡在第一步。它不是“可选插件”，而是远程调试的基础设施——VS Code 本地端靠它建立 SSH 连接、同步文件、启动远程服务；远程服务器上也会自动部署一个轻量级 server（叫 VS Code Server），用于响应编辑、终端、调试等请求。
安装方式很简单：打开 VS Code 扩展面板（Ctrl+Shift+X），搜 Remote-SSH，点安装。注意别装错成旧版 Remote SSH（无连字符）或第三方仿品。
常见错误现象：
- 点击左下角
<>图标后，弹出菜单里没有Connect to Host - 按
Ctrl+Shift+P输入Remote-SSH，命令列表为空
这两个迹象基本说明插件没装成功或被禁用。重装后重启 VS Code，再试一次。
SSH 配置文件路径和 Host 写法要严格匹配
~/.ssh/config 是 VS Code 查找连接信息的唯一入口。它不读你终端里写的 ssh user@host -p 2222 命令，也不认剪贴板里的连接串。必须显式写进这个文件，格式稍有偏差就会报 Could not establish connection to "xxx"。
正确写法示例（Linux/macOS）：
Host myserver HostName 192.168.1.100 User lbs Port 2222 IdentityFile ~/.ssh/id_rsa
关键点：
-
Host名（如myserver）是你在 VS Code 里选择的目标名，不能含空格或特殊符号 -
HostName必须是 IP 或可解析域名，不能写ssh lbs@192.168.1.100 - 如果用了非标准端口（如
2222），Port行不能省略 -
IdentityFile路径必须绝对，且本地私钥文件要有正确权限（chmod 600）
Windows 用户注意：~ 在 Windows 下指向 C:\Users\用户名\.ssh\，别手误写成 C:/Users/... 或漏掉反斜杠转义。
launch.json 的 type 和 request 必须匹配运行模式
远程调试失败，八成出在 launch.json 配置。它不是通用模板，得按你实际怎么跑程序来选参数。
比如 Python 调试：
- 如果你是直接运行脚本：
"request": "launch"，"program"指向远程服务器上的.py文件路径（如/home/lbs/project/main.py） - 如果你是 attach 到已运行进程（如 Flask 服务）：
"request": "attach"，必须确保远程进程已用--debug或-m debugpy启动，并监听指定端口
常见坑：
-
"pythonPath"字段在新版 VS Code + Remote-SSH 中已废弃，删掉它；改用左下角状态栏手动选解释器（会列出远程环境中的所有python可执行路径） - C++ 调试时，
"program"必须是带调试符号的二进制（编译时加-g），否则断点灰色不可用 - Node.js 的
"port"默认是9229，但如果你用node --inspect=0.0.0.0:9229 app.js启动，就得确认远程防火墙放行该端口，且launch.json中"address"设为"0.0.0.0"（而非默认"localhost"）
远程调试器进程必须在服务器端真实运行
VS Code 本地只是“遥控器”，真正干活的是远程服务器上的调试代理。很多人卡在“F5 没反应”或“timeout”，其实只是远程那头根本没起来。
验证方法很直接：SSH 登录服务器，执行 ps aux | grep -i debug（Python）、ps aux | grep gdbserver（C/C++）、lsof -i :9229（Node.js）。如果没输出，说明调试器没启动。
对应处理：
- Python：确保已
pip install debugpy，且launch.json中"request": "launch"时，VS Code 会自动注入；但"request": "attach"时，你得自己在终端里先跑python -m debugpy --listen 0.0.0.0:5678 --wait-for-client main.py - C++：
gdbserver必须提前安装（sudo apt install gdbserver），且命令中端口前要加冒号，如gdbserver :5000 ./a.out，不能写成gdbserver 5000 ./a.out - 别依赖“自动启动”——尤其第一次调试，手动在远程终端敲一遍启动命令，看到
Listening on port 5678这类日志，再回 VS Code 点 F5，成功率高得多。
最常被忽略的一点：远程服务器的 SELinux 或 AppArmor 可能拦截调试器绑定端口，特别是非标准端口（如 5678、5000）。临时关掉它们测试（sudo setenforce 0）能快速定位是否是权限问题。
