0

0

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

夜晨

夜晨

发布时间:2026-01-17 14:32:02

|

781人浏览过

|

来源于php中文网

原创

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

怎么用vscode进行远程服务器开发?【教程】

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 22firewall-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_configPasswordAuthentication yes 已启用并重载服务:sudo systemctl restart sshd

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

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

易优制冷机械设备网站源码1.6.9
易优制冷机械设备网站源码1.6.9

易优制冷机械设备网站源码是基于易优cms开发,适合企业进行制冷设备展示使用。程序内核为Thinkphp5.0开发,后台简洁,为企业网站而生。 这是一套安装就能建站的程序,不定期更新程序BUG,更新网站功能。 我们提供的不仅是模板这么简单,我们还提供程序相关咨询、协助安装等服务。 默认不包含小程序插件,需要另外单独购买插件。 模板安装步骤 1、请将安装包ZIP上

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

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

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

  • 右键点击左下角远程连接状态栏 → Remote Extension Recommendations,只启用真正需要的远程扩展(如 PythonPylance
  • files.excludesearch.exclude 加上 **/node_modules**/__pycache__ 等目录
  • 禁用非必要本地扩展的远程同步:在扩展详情页点齿轮图标 → Extension Settings → 关掉 Remote: Extension Kind 中的 workspace
远程开发最麻烦的从来不是连不上,而是连上了却不知道为什么某些功能“半残”——比如终端不读 ~/.bashrc、Git 图标不刷新、或者保存文件等三秒才响应。这些问题几乎都藏在 SSH 配置、shell 初始化逻辑、或扩展同步策略里,而不是 VSCode 界面按钮上。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

758

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

639

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

761

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

618

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1264

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

548

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

579

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

708

2023.08.11

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

41

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7.3万人学习

Git 教程
Git 教程

共21课时 | 2.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号