怎么用VSCode进行远程服务器开发？【教程】

Remote-SSH插件安装后不能直接连接，需确保本地SSH客户端可用、服务器sshd运行、防火墙放行22端口、认证方式有效，并正确配置~/.ssh/config中的HostName、User、Port和IdentityFile。

Remote-SSH 插件装完就等于能连上？

不是。装了 Remote-SSH 插件只是第一步，真正连接前必须确保本地 SSH 客户端可用、服务器 SSH 服务已启用、且密钥或密码认证通路畅通。Windows 用户若没装 OpenSSH Client（Win10 1809+ 默认带，但可能被禁用），会卡在“Resolving host…”不动；macOS 和 Linux 一般自带，但需确认 ssh -V 能正常输出版本。

• 检查本地 SSH：运行 ssh -T git@github.com，能返回成功提示说明基础环境 OK
• 服务器端确认 sshd 正在运行：sudo systemctl is-active sshd（Ubuntu/CentOS 7+）
• 防火墙要放行 22 端口（或自定义端口），ufw allow 22 或 firewall-cmd --add-port=22/tcp --permanent
• 首次连接建议用密码登录一次，让 VSCode 自动把公钥追加到服务器的 ~/.ssh/authorized_keys

配置 SSH Host 时路径和用户写错会导致反复重连失败

VSCode 的 Remote-SSH 依赖 ~/.ssh/config 或内置连接字符串。常见错误是把 HostName 写成内网 IP 却从外网连，或漏写 User 导致默认用当前本地用户名（而服务器上不存在该用户）。如果服务器改过 SSH 端口，必须显式指定 Port，否则永远走 22。

• 推荐在 ~/.ssh/config 中写明配置，例如：

Host myserver
    HostName 192.168.1.100
    User ubuntu
    Port 2222
    IdentityFile ~/.ssh/id_rsa_server

• 在 VSCode 命令面板（Ctrl+Shift+P）中选 Remote-SSH: Connect to Host...，再选 myserver，别手输连接串
• 如果用密码登录，确保服务器 /etc/ssh/sshd_config 中 PasswordAuthentication yes 已启用并重载服务：sudo systemctl restart sshd

远程窗口里打开的终端默认不是 Bash，PATH 和别名都失效

VSCode 远程连接后新建的集成终端，默认 shell 是 /bin/sh（尤其在 Ubuntu Server 等最小化安装系统上），导致你配置的 ~/.bashrc 不加载、conda 命令找不到、甚至 ll 别名报错。这不是 VSCode bug，是远程系统本身的 shell 行为。

Cursor

一个新的IDE，使用AI来帮助您重构、理解、调试和编写代码。

下载

• 在远程窗口中打开命令面板，执行 Terminal: Select Default Profile，选 bash 或 zsh（取决于你服务器实际 shell）
• 更彻底的解决：在远程服务器上执行 chsh -s $(which bash) 把登录 shell 改为 bash
• 如果仍不生效，检查 VSCode 设置里的 terminal.integrated.defaultProfile.linux 是否被覆盖为 sh

文件保存慢、Git 操作卡顿，大概率是扩展同步出了问题

VSCode 默认会把部分扩展（尤其是语言服务类）同步到远程服务器运行，但如果扩展本身不支持远程、或远程环境缺依赖（比如没装 node、python3），就会反复尝试启动失败，拖慢整个编辑器响应。Git 提交变慢常是因为 GitLens 或 ESLint 在远程扫描超大 node_modules 目录。

• 右键点击左下角远程连接状态栏 → Remote Extension Recommendations，只启用真正需要的远程扩展（如 Python、Pylance）
• 把 files.exclude 和 search.exclude 加上 **/node_modules、**/__pycache__ 等目录
• 禁用非必要本地扩展的远程同步：在扩展详情页点齿轮图标 → Extension Settings → 关掉 Remote: Extension Kind 中的 workspace