讲师中心 微信公众号
AI工具推荐 视频效率加速

VSCode怎么配置Linux远程开发环境

落伟酱_3693

落伟酱_3693

发布时间:2026-05-21 15:39:29

|

1089人浏览过

|

来源于php中文网

原创

Remote-SSH连接需安装Remote Development扩展包而非单个插件,配置本地~/.ssh/config文件,确保公钥正确写入远程authorized_keys并重启sshd,首次连接耐心等待vscode-server自动部署完成。

vscode怎么配置linux远程开发环境

能直接用 SSH 连上 Linux 服务器、在本地 VS Code 里编辑远程文件、运行终端、装插件到远端——这件事本身不难,但卡在某个环节就全盘失败。核心前提是:本地有可用的 ssh 客户端,远程 sshd 服务开着且允许你登录。

Remote - SSH 插件必须装对,不是只装一个

VS Code 的远程开发能力由 Remote - SSH 提供,但它依赖 Remote Development 扩展包作为底层支持。只搜“Remote-SSH”并安装单个插件,大概率会缺功能(比如连接后无法加载远端插件、终端打不开)。

  • 正确做法:在扩展市场搜索 Remote Development,安装那个带蓝色图标、描述为“Remote Development extension pack”的官方套件
  • 装完后,状态栏左下角会出现绿色的远程图标,点它才能唤出 Remote-SSH: Connect to Host 命令
  • 别信“只装 Remote-SSH 就够了”的旧教程——2026 年起,微软已明确将三类远程能力(SSH / WSL / Container)统一打包

SSH 配置文件路径和格式不能错,尤其 Windows 用户

VS Code 读取的是你本地的 ~/.ssh/config(Windows 是 C:\Users\{username}\.ssh\config),不是远程服务器上的那个。很多人误把远程的 /etc/ssh/sshd_config 当成配置目标,结果连不上还反复改远端设置。

  • 配置项必须顶格写,不能缩进;Host 名称不能含空格或特殊符号
  • 典型正确写法:
Host myserver
  HostName 192.168.1.26
  User root
  Port 22
  IdentityFile ~/.ssh/id_ed25519

注意:IdentityFile 路径在 Windows 上要写成 C:\Users\xxx\.ssh\id_ed25519 或用正斜杠 C:/Users/xxx/.ssh/id_ed25519,反斜杠不识别。

linux-performance-analyzer
linux-performance-analyzer

Linux 性能分析与调优专家,覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景:系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。

下载

免密登录失败,八成是公钥没进 authorized_keys

本地生成密钥对后,只改了 VS Code 的 config 文件,却没把公钥内容真正放进远程服务器的 ~/.ssh/authorized_keys,连接时仍会弹密码框。

  • 检查远程服务器上该文件权限:chmod 700 ~/.ssh && chmod 600 ~/.ssh/authorized_keys
  • 确认 sshd 配置允许公钥登录:PubkeyAuthentication yes 和 AuthorizedKeysFile .ssh/authorized_keys 必须在 /etc/ssh/sshd_config 中启用
  • 如果用的是 root 登录,还要确保 PermitRootLogin yes(某些发行版默认禁用)
  • 改完 sshd_config 后必须执行 sudo systemctl restart sshd,否则无效

第一次连接后远端 VS Code Server 启动慢,别手抖关掉

首次通过 Remote-SSH 连接某台 Linux 主机时,VS Code 会在远端自动下载、解压、启动一个轻量服务端(vscode-server)。这个过程可能持续 30–90 秒,期间界面卡在“Installing VS Code Server”不动,很多人以为失败就强制退出。

  • 此时远端其实正在后台运行 curl 下载和 tar 解压,可登录服务器执行 ps aux | grep vscode 确认
  • 若中途断开,下次重连会从头开始——所以耐心等完第一次初始化,后续连接就秒开了
  • 如果等太久(超 3 分钟)仍无响应,大概率是远端网络策略拦截了 GitHub Release 下载(国内常见),需手动下载 vscode-server tar 包传上去解压

最常被忽略的一点:所有你在远程窗口里装的插件(比如 C/C++、Go),实际是安装在 Linux 服务器上的 ~/.vscode-server 目录里,和本地插件完全隔离。这意味着你不能指望本地已装的调试器直接跑远端代码——得让远端自己装、自己配环境变量、自己找 gdb 或 dlv。

热门AI工具

更多
讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

1195

2023.06.30

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2392

2023.07.21

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1829

2024.03.14

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1687

2024.03.14

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2567

2024.03.15

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1798

2024.03.15

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1222

2024.03.15

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1096

2024.03.15

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

120

2026.09.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn