跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / Bash

Windows 下使用 VSCode 结合 WSL 进行远程开发配置

在 Windows 系统上使用 VSCode 配合 WSL(Windows Subsystem for Linux)构建统一开发环境的方案。通过启用 WSL 内的 SSH 服务,并利用内网穿透工具将本地端口映射至公网,开发者可实现跨设备、跨网络的远程代码编写与调试。该方案解决了局域网访问限制问题,支持团队协作及移动办公,确保开发与部署环境一致性,减少兼容性问题。

星辰大海发布于 2026/3/15更新于 2026/9/969 浏览
Windows 下使用 VSCode 结合 WSL 进行远程开发配置

VSCode 结合 WSL(Windows 的 Linux 子系统),能在 Windows 系统上无缝运行完整的 Linux 开发工具链。它的功能核心是实现双系统的高效协同 —— 开发者既能用 Windows 的图形界面优势,又能调用 Ubuntu 等 Linux 发行版的命令行工具,适合需要跨系统开发的程序员、学生或技术团队,优点是比虚拟机轻便,性能接近原生,还支持 SSH 远程连接 WSL 环境。

使用这段时间,最大的感受是开发环境统一了。以前在 Windows 上写 Linux 相关代码,总担心兼容性问题,现在直接在 WSL 里编译、运行,和实际部署环境一致,减少了很多'本地能跑线上报错'的麻烦。不过要注意,WSL 的网络设置需要偶尔检查,确保服务正常启动。

但它有个明显局限:默认只能在局域网内访问。比如家里的电脑部署了环境,出差时想改代码,就只能远程操控电脑,操作繁琐;团队协作时,同事不在同一网络也无法共享开发环境,效率受影响。

而搭配内网穿透工具后,这个问题就解决了。该工具能把 WSL 的 SSH 服务映射到公网,相当于给开发环境开了个'全球通道'。现在无论是在咖啡厅、机场,只要有网络,就能用另一台设备通过 VSCode 远程连接回家中的环境,继续写代码、调试程序,团队成员也能通过公网地址共享同一环境,协作更顺畅。

1. WSL 环境下网络诊断

首先搜索 Ubuntu,打开应用。

查看你的 ip 地址:

ip addr 

检查是否可以从当前机器访问目标 IP 为 172.20.54.177 的服务器上的 SSH 服务(端口 22):

telnet 172.20.54.177 22

使用 SSH 协议,以用户名 michael 尝试连接到 IP 地址为 172.20.54.177 的服务器,并且指定使用端口 22 进行连接:

ssh [email protected] -p22

如何在 Ubuntu 上启用 SSH?

sudo apt install openssh-server 

2. 安装工具实现随时随地开发

该工具可以将你本地电脑中的服务(如 SSH、Web、数据库)映射到公网。即使你在家里或外出时,也可以通过公网地址连接回本地运行的开发环境。配合 VSCode 的 Remote - SSH 插件,你可以从任何设备访问自己的完整开发环境。

以下是安装步骤:

下载最新版本并安装(一路默认安装即可)。本教程选择下载 Windows 版本。

安装成功后,在浏览器上访问 http://localhost:9200,使用该工具的账号登录,登录后即可看到 Web 配置界面,接下来在 web 管理界面配置即可。

3. 配置公网地址

通过配置,你可以在本地 WSL 或 Linux 系统上运行 SSH 服务,并通过该工具将其映射到公网,从而实现从任意设备远程连接开发环境的目的。

  • 隧道名称:可自定义,本例使用了 VsCode,注意不要与已有的隧道名称重复
  • 协议:tcp
  • 本地地址:172.20.54.177:22
  • 端口类型:随机临时 TCP 端口
  • 地区:China Vip

创建成功后,打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址,接下来就可以在其他电脑或者移动端设备(异地)上,使用任意一个地址在终端中访问即可。

  • tcp 表示使用的协议类型
  • 域名是该工具提供的
  • 端口号是随机分配的公网端口号

通过该工具提供的公网地址和端口,使用 SSH 协议从本地 Windows 系统连接到远程的 Ubuntu WSL2 环境,并成功登录。

ssh [email protected] -p12825

4. VSCode 远程连接开发环境

无论你是在 Windows、macOS 还是 Linux 上工作,Remote - SSH 让你可以连接到任何支持 SSH 的系统(Linux 或 macOS),提供了一致的开发环境。通过在相同环境中开发和部署,可以减少'在我的机器上能运行'的问题。

打开 VS Code,按下 Ctrl + Shift + X(或点击左侧活动栏中的扩展图标),进入扩展市场。在搜索栏中输入关键词'Remote - SSH',在搜索结果中找到'Remote - SSH'插件,点击 Install 按钮进行安装。

安装完成后,左侧资源管理器下方会出现一个新的远程资源管理器图标(或直接使用快捷键 Ctrl+Shift+P 输入'Remote-SSH'相关命令),即可开始配置并连接远程服务器。点击小加号就可以连接远程服务器。

点击小加号后,输入框会弹出一个输入框,这个输入框用于输入 SSH 的连接命令。

ssh [email protected] -p12825

然后软件的右下角会出现提示信息,点击'打开配置'打开配置文件。

  • Host:这是一个用户定义的别名,用于指代远程主机。
  • HostName:指定远程主机的实际地址或主机名。
  • User:指定连接到远程主机时使用的用户名。
  • Port:指定 SSH 连接使用的端口号。

此时,你应该能在左侧资源管理器的 SSH 目标列表中看到新增的 Ubuntu 主机项。如果未自动显示,可以点击上方的刷新按钮进行手动更新。确认出现目标主机后,点击主机名右侧的连接按钮,即可开始远程连接到该 Ubuntu 系统。

点击连接后,选择 Linux。

然后输入远程的主机密码,按下回车。

连接成功后,出现的字样。

点击右下角的小三角,再点击'TERMINAL(终端)',可以看到 Ubuntu 的终端界面,在这里可以使用命令行操作 Ubuntu。

输入:

code .

新弹出的页,再次输入主机密码。

这样就可以随时随地编写代码啦。

5. 保留固定 TCP 公网地址

使用该工具为其配置 TCP 地址,该地址为固定地址,不会随机变化。

选择区域和描述:有一个下拉菜单,当前选择的是

目录

  1. 1. WSL 环境下网络诊断
  2. 2. 安装工具实现随时随地开发
  3. 3. 配置公网地址
  4. 4. VSCode 远程连接开发环境
  5. 5. 保留固定 TCP 公网地址

更多推荐文章

查看全部
  • 多旋翼物流无人机节能轨迹规划与 Python 实现
  • 前端大数据导出优化:解决 Chrome 内存崩溃的实战方案
  • 如何让英文大语言模型支持中文:继续预训练指南
  • 十大 AI 论文降重与智能写作工具评测
  • AHP-LLM 在 AI 辅助开发中的实践:从算法选择到工程落地
  • Copilot 人工智能助手功能与版本介绍
  • Flutter web_scraper 库在 OpenHarmony 环境下的网页抓取适配实战
  • C++ 高频面试考点:语言基础与预处理
  • Python 爬虫快速入门
  • SystemVerilog 全面教程:从基础到高级验证
  • 2024 前端主流框架演进与性能优化实践总结
  • 2026 年 3 月全球 AI 前沿动态
  • Python 爬虫基础教程:从原理到实战代码详解
  • ComfyUI Web Viewer:实现图像生成的实时预览与协作
  • 如何在Llama-Factory中自定义损失函数?高级用法指南
  • Axure 制作 AI 自动对话机器人原型教程
  • Webnovel Writer:基于 Claude Code 的长篇网文 AI 创作系统
  • Cursor 中 MCP 服务配置与使用指南
  • 高防服务器防御 DDoS 攻击的核心策略与实战
  • Go 语言高频面试题核心解析与实战指南

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online