VSCode连接Linux服务器(详细图解，远程开发不求人)-VSCode-PHP中文网

VSCode连接Linux服务器(详细图解，远程开发不求人)

爱谁谁

发布： 2025-08-17 20:35:01

原创

540人浏览过

<p>答案是利用VSCode的“Remote - SSH”扩展实现本地编辑与远程服务器的无缝连接。首先在本地安装VSCode及Remote - SSH扩展，通过添加SSH连接字符串（如devuser@192.168.1.100）配置服务器信息并保存至~/.ssh/config文件，确保私钥权限为600、SSH服务正常运行且防火墙放行对应端口。连接成功后，VSCode新窗口将直接操作服务器文件系统，支持远程终端、调试和扩展运行，避免本地环境依赖与文件同步问题。常见问题包括SSH认证失败、配置语法错误或依赖缺失，需检查网络、服务状态及日志输出。优势在于结合本地IDE体验与远程计算资源，提升开发效率，支持端口转发、Agent转发和Docker容器开发，适用于大型项目与团队协作场景。</p>

vscode连接linux服务器(详细图解，远程开发不求人)

VSCode连接Linux服务器进行远程开发，说白了就是让你能像在本地一样，用VSCode直接编辑、运行和调试服务器上的代码。这大大简化了开发流程，省去了文件同步的麻烦，也让你可以充分利用服务器的计算资源，尤其是在处理大型项目或需要特定环境时，简直是神器。

解决方案

要实现VSCode与Linux服务器的无缝连接，核心在于利用VSCode的“Remote - SSH”扩展。

你首先得确保VSCode已经安装在你的本地机器上。接着，在VSCode的扩展商店里搜索并安装“Remote - SSH”这个扩展。安装好后，你会发现VSCode的左侧活动栏多了一个“远程资源管理器”的图标（看起来像一个显示器上面有个插头）。

点击这个图标，然后你会看到一个“SSH”的下拉菜单。通常，你会点击那个小齿轮图标或者加号按钮来添加新的SSH主机。VSCode会提示你输入SSH连接字符串，格式一般是

user@hostname

登录后复制

或者

user@IP地址

登录后复制

。比如，你的服务器IP是

192.168.1.100

登录后复制

，用户名是

devuser

登录后复制

，你就输入

devuser@192.168.1.100

登录后复制

。

输入后，VSCode会问你选择哪个配置文件来保存这个连接信息。通常，选择第一个选项，让它自动帮你配置到你的用户SSH配置文件里（比如

~/.ssh/config

登录后复制

）。这个文件非常有用，你可以手动编辑它，加入更多细节，比如特定的端口号（

Port 2222

登录后复制

）、私钥路径（

IdentityFile ~/.ssh/id_rsa_my_server

登录后复制

）或者代理跳转（

ProxyJump

登录后复制

）等等。

配置完成后，在远程资源管理器里，你就能看到你刚刚添加的服务器了。点击它旁边的小窗口图标，VSCode就会在一个新窗口中尝试连接到你的Linux服务器。第一次连接时，可能会提示你确认服务器的指纹信息，这是为了安全，确认无误后选择“继续”。然后，如果你的SSH配置没有使用密钥对认证，它会要求你输入密码。输入正确的密码后，稍等片刻，一个全新的VSCode窗口就会打开，但这个窗口里你看到的文件系统、终端、甚至你安装的扩展，都已经是服务器上的了。你可以像在本地一样操作文件、打开终端运行命令、安装和使用各种开发工具。

连接失败？这些常见问题和解决方案你得知道

说实话，我刚开始用这功能的时候，也踩过不少坑。最常见的问题往往出在SSH连接本身，而不是VSCode。

一个常见的情况是SSH私钥的权限问题。如果你使用了SSH密钥对进行认证，确保你的私钥文件（比如

~/.ssh/id_rsa

登录后复制

）权限是

登录后复制

，也就是只有你自己能读写。如果权限太开放，SSH客户端会出于安全考虑拒绝使用它。你可以用

chmod 600 ~/.ssh/id_rsa

登录后复制

命令来设置。

再一个就是服务器端的SSH服务是不是正常运行，或者防火墙有没有阻挡了22端口（或者你自定义的SSH端口）。你可以尝试在本地终端直接

ssh user@IP

登录后复制

看看能不能连上。如果连不上，那问题多半在服务器端。检查服务器的SSH服务状态（例如

systemctl status sshd

登录后复制

在Systemd系统上），或者看看防火墙规则（

sudo ufw status

登录后复制

或

sudo firewall-cmd --list-all

登录后复制

）。

有时候，VSCode在服务器上安装它的“远程服务器”组件时会遇到问题。这可能是因为服务器的

glibc

登录后复制

版本太老，或者缺少一些必要的依赖库。VSCode的输出窗口（不是终端）会显示详细的错误信息，仔细看看这些信息，通常能找到线索。比如，它可能会提示某个库文件找不到。遇到这种情况，你可能需要更新服务器系统，或者手动安装缺失的依赖。

别忘了检查

~/.ssh/config

登录后复制

文件的语法。一个小小的拼写错误或者格式不对，都可能导致连接失败。VSCode的输出窗口也会提示配置解析错误。

网络连接本身的问题也可能导致连接失败，比如IP地址输错了，或者根本就连不上服务器的网络。这需要你从网络层面去排查。

音刻

AI音视频转录和笔记工具

107

查看详情

为什么选择VSCode进行Linux远程开发？它的优势在哪里？

说实话，这玩意儿彻底改变了我写代码的方式。以前搞远程开发，要么是Vim/Emacs加SSH，要么就是本地改代码然后FTP/SCP上传，效率低下不说，调试起来更是痛苦。VSCode的Remote - SSH扩展，真的把远程开发体验提升到了一个全新的高度。

最大的优势在于，它让你能享受到本地IDE的所有便利，但代码却实实在在地跑在远程服务器上。这意味着你可以使用VSCode丰富的扩展生态系统——代码补全、语法高亮、Git集成、调试器等等，所有这些你习惯的工具，都能在远程文件上无缝使用。你的本地机器不需要安装任何服务器端的依赖，比如Node.js、Python环境、Go编译器等等，它们都在服务器上。这解决了本地环境污染和配置复杂的问题。

其次，文件同步的烦恼彻底消失了。你打开文件、保存文件，都是直接在服务器上操作，没有延迟，也没有版本不一致的风险。对于大型项目，本地机器的性能可能不足以流畅运行，但服务器通常拥有更强大的CPU、内存和存储，可以轻松应对编译、测试等耗资源的操作。

此外，它还提供了统一的开发环境。团队成员连接到同一个开发服务器，可以确保每个人都在相同的环境下工作，减少了“我的机器上可以运行”的问题。代码本身也始终保留在服务器上，对于一些需要高度安全或保密的场景，这无疑是一个巨大的优势。

提升效率：VSCode远程开发的进阶技巧与最佳实践

用久了你就会发现，有些小技巧能让你的开发体验更上一层楼。

首先，好好利用

~/.ssh/config

登录后复制

文件。它不仅仅是保存主机名和IP，你可以为不同的服务器设置别名（

Host my_dev_server

登录后复制

），指定不同的用户名（

User devuser

登录后复制

）、端口（

Port 2222

登录后复制

），甚至配置SSH Agent Forwarding（

ForwardAgent yes

登录后复制

），这样你在远程服务器上操作Git时，就不需要再次输入SSH密钥密码了。对于复杂的网络环境，

ProxyJump

登录后复制

更是神器，可以让你通过一个跳板机连接到内网的服务器。

端口转发也是一个非常实用的功能。如果你在远程服务器上运行了一个Web服务（比如React开发服务器在3000端口），或者数据库（比如PostgreSQL在5432端口），你可以在VSCode的“端口”面板中设置端口转发。这会将远程服务器上的特定端口映射到你本地机器的一个端口，这样你就可以直接在本地浏览器访问

localhost:3000

登录后复制

来看到远程服务器上的Web应用，或者用本地的数据库客户端连接远程数据库。

关于扩展，记住一点：大多数扩展是安装在远程服务器上的。当你连接到远程服务器后，VSCode会提示你安装推荐的扩展。安装在远程的扩展可以充分利用服务器的计算资源，比如Python的LSP（语言服务器协议）服务，在服务器上运行会更快。

最后，如果你在远程服务器上使用Docker，VSCode的“Remote - Containers”扩展和“Remote - SSH”可以完美结合。你可以先通过SSH连接到服务器，然后在这个远程VSCode窗口里，再用Remote - Containers连接到服务器上的Docker容器。这提供了极致的开发环境隔离和一致性。

这些技巧掌握后，你会发现VSCode的远程开发能力远超你的想象，几乎能满足所有远程工作的需求。

以上就是VSCode连接Linux服务器(详细图解，远程开发不求人)的详细内容，更多请关注php中文网其它相关文章！