vs code remote-ssh 连接失败主因是本地 ssh 配置问题，需先确保终端能免密 ssh user@host 登录；常见卡点为“installing vs code server”，多因网络、权限或基础工具缺失；调试断点失效和中文乱码则源于环境配置不一致。
vscode 连不上远程服务器的 ssh 连接失败
连不上，大概率不是 VS Code 问题，而是本地 ssh 配置没走通。VS Code 的 Remote-SSH 插件本质是调用你本机的 ssh 命令，它连不通，插件一定连不上。
- 先在终端手动执行
ssh user@host，确认能免密登录；如果要输密码，ssh密钥没配好，Remote-SSH 默认不支持密码交互（除非改配置） - 检查
~/.ssh/config里有没有拼错HostName、User或多写了空格；Windows 用户注意路径是%USERPROFILE%\.ssh\config - 防火墙或服务器端禁了
sshd的非标准端口？确认Port配置和服务器/etc/ssh/sshd_config一致 - WSL 用户容易忽略：WSL 里装了
openssh-server，但没开服务，sudo service ssh start才行
Remote-SSH 启动后卡在 “Installing VS Code Server”
这是最常卡住的环节——VS Code 尝试在远程服务器上下载并解压一个专用 server 包，但网络、权限或磁盘空间可能拦路。
- 服务器不能访问 GitHub Releases（比如国内服务器），会超时；可提前手动下载对应版本到服务器：
curl -L https://update.code.visualstudio.com/commit:<code>版本号/server-linux-x64/stable -o vscode-server.tar.gz，再解压到~/.vscode-server/bin/<code>版本号/ - 目标目录
~/.vscode-server所在文件系统只读？比如挂载了 NFS 或容器卷；换tmpfs或本地磁盘路径，通过"remote.SSH.serverPickPortsFromRange"等配置绕不过权限问题 - 服务器没装
tar或gzip？某些最小化镜像（如 Alpine）缺这些基础工具，安装即可
断点不命中，调试器显示 “No symbols loaded”
不是代码写错了，而是调试器根本没加载到源码映射。Node.js / Python / Go 各有各的坑，但共性在于路径映射没对齐。
- Node.js 调试时，确保启动命令加了
--inspect=0.0.0.0:9229，且launch.json里port和address匹配；别用127.0.0.1，得用0.0.0.0让远程端口可被 VS Code 访问 - Python 项目若用
venv，远程python解释器路径必须指向venv/bin/python，否则断点在源码，实际运行的是系统 Python - Go 项目开启
dlv时，加--headless --api-version=2 --accept-multiclient --continue --dlv-load-config={"followPointers":true,"maxVariableRecurse":1,"maxArrayValues":64,"maxStructFields":-1}，否则变量展开异常、断点跳过
远程终端中文乱码或命令补全失效
这不是 VS Code 显示问题，而是远程 shell 的 locale 和 readline 没初始化好，影响日常开发效率。
- 检查远程服务器
locale输出是否含UTF-8；若为POSIX，在~/.bashrc或~/.zshrc加export LANG=en_US.UTF-8（或对应中文 locale） - 如果用了 zsh + oh-my-zsh，远程首次连接时
.zshrc可能没执行完（尤其带网络请求的插件）；把耗时逻辑用if [[ -n $SSH_CONNECTION ]]; then ... fi包起来 - 补全失效常见于未启用
bash-completion或zsh-autosuggestions；确认~/.bash_completion被 source，或 zsh 中plugins=(...)已包含对应项
which python 在终端里跑一次、在调试器里跑一次，结果可能完全不同。
