---
title: Cursor 连接 WSL 开发指南
icon: mdi:microsoft-windows
date: 2026-02-04
category:
  - 开发工具
  - 前端
tag:
  - Cursor
  - WSL
  - Windows
  - 开发环境
---

# Cursor 连接 WSL 开发指南

本指南包含 Windows 系统选择、WSL2 概念解释以及 Cursor 连接 WSL 开发的完整教程。

<!-- more -->

## 前言

本指南整理自与 Cursor AI 的对话，包含 Windows 系统选择、WSL2 概念解释以及 Cursor 连接 WSL 开发的完整教程。

---

## 一、Windows 10 vs Windows 11 Pro 稳定性对比

### 1.1 结论

**Windows 10 最新版本（23H2）通常比 Windows 11 更稳定。**

### 1.2 原因分析

| 特性 | Windows 10 | Windows 11 |
|------|------------|------------|
| 成熟度 | 经过多年优化，成熟稳定 | 相对较新，部分功能仍在完善 |
| 兼容性 | 对老旧硬件和软件支持更好 | 要求 TPM 2.0，部分老硬件不兼容 |
| 更新策略 | 主要是维护性更新，变化小 | 持续有新功能更新，变化较多 |
| 驱动支持 | 驱动程序支持更广泛 | 部分老驱动可能不兼容 |

### 1.3 推荐选择

- **专业软件开发/企业环境**：推荐 Windows 10 Pro
- **新硬件/追求新功能**：可以选择 Windows 11 Pro

---

## 二、Java/Go/Vue 开发系统推荐

### 2.1 推荐：Windows 11 专业版

对于 Java、Go、Vue 开发，**强烈推荐 Windows 11 专业版**。

### 2.2 优势说明

1. **WSL2 性能优化**
   - 启动速度快（几秒 vs 几十秒）
   - 资源占用少
   - 与 Windows 集成度高

2. **Docker Desktop 支持更好**
   - 容器运行更稳定
   - 资源管理更高效

3. **Windows Terminal 原生支持**
   - 开发体验更流畅
   - 多标签页管理方便

### 2.3 各技术栈支持情况

| 技术栈 | Windows 10 | Windows 11 | 说明 |
|--------|------------|------------|------|
| Java | ✅ 良好 | ✅ 良好 | 两者完美支持 |
| Go | ✅ 良好 | ✅ 良好 | 跨平台编译 |
| Vue | ✅ 可用 | ✅ 优秀 | WSL2 下开发体验极佳 |
| Docker | ✅ 可用 | ✅ 优秀 | WSL2 集成更好 |

---

## 三、WSL2 详解

### 3.1 WSL2 是什么

**WSL2 = Windows Subsystem for Linux 2**

即 Windows 上的 Linux 子系统，让 Windows 用户无需安装虚拟机或双系统，直接运行 Linux 环境。

### 3.2 WSL2 vs 虚拟机对比

| 特性 | WSL2 | 虚拟机 |
|------|------|--------|
| 启动速度 | 几秒 | 几十秒 |
| 资源占用 | 少 | 多 |
| 集成度 | 与 Windows 无缝集成 | 独立运行 |
| 性能 | 接近原生 Linux | 有一定损耗 |

### 3.3 WSL2 核心特性

- **独立文件系统**：拥有自己的 Linux 目录结构
- **独立用户系统**：有独立的用户和权限管理
- **独立包管理**：使用 apt、yum 等 Linux 包管理器
- **资源共享**：与 Windows 共享 CPU、内存、网络

### 3.4 文件系统访问

```
Windows 目录              WSL2 访问位置
─────────────────────────────────────
C:\myproject     →     /mnt/c/myproject

WSL2 目录               Windows 访问位置
─────────────────────────────────────
~/myproject       →     \\wsl$\Ubuntu\home\user\myproject
```

---

## 四、Cursor 连接 WSL 开发教程

### 4.1 原理说明

Cursor 采用 **Server-Client 架构** 连接 WSL：

```
┌─────────────────────────────────────────────────────────┐
│                      Windows 端                          │
│  ┌─────────────┐      ┌─────────────┐                   │
│  │  Cursor GUI │◄────►│ WSL 插件     │                   │
│  │  (前端界面)  │      │ (Server)    │                   │
│  └─────────────┘      └──────┬──────┘                   │
└──────────────────────────────┼───────────────────────────┘
                                │ SSH/IPC 通信
                                ▼
┌─────────────────────────────────────────────────────────┐
│                      WSL 端                              │
│                ┌─────────────────────┐                 │
│                │ VS Code Server      │                 │
│                │ (后端服务)           │                 │
│                └─────────────────────┘                 │
│                       │    │                          │
│               文件系统 │    │ 终端/调试               │
│                       ▼    ▼                          │
│              ┌─────────────────────┐                   │
│              │  Linux 环境         │                   │
│              │  (Java/Node/Go 等)  │                   │
│              └─────────────────────┘                   │
└─────────────────────────────────────────────────────────┘
```

### 4.2 操作步骤

#### 步骤 1：安装 WSL 扩展

1. 打开 Cursor
2. 按 `Ctrl + Shift + X` 打开扩展面板
3. 搜索 "WSL"
4. 安装 **"WSL"** 插件（Microsoft 官方）

#### 步骤 2：进入 WSL 并打开项目

```bash
# 1. 打开 Cursor 终端 (Ctrl + `)
# 2. 进入 WSL 项目目录

cd ~/你的项目路径
# 或访问 Windows 项目
cd /mnt/c/Windows 上的项目路径

# 3. 在 Cursor 中打开
code .
```

#### 步骤 3：确认 WSL 模式

连接成功后，Cursor 左下角会显示：
- "WSL: Ubuntu" 或你安装的发行版名称
- 终端默认是 Linux bash 环境
- 使用 Linux 版本的开发工具

---

## 五、Cursor SSH 连接远程 Linux 服务器

### 5.1 原理图解

```
Cursor (Windows) 
    │
    │ Remote - SSH 插件
    ▼
┌─────────────────┐
│ SSH 连接到服务器  │
│ user@192.168.x  │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│ 服务器上的       │
│ VS Code Server  │
└────────┬────────┘
         │
         │ 远程开发
         ▼
     项目目录开发
```

### 5.2 操作步骤

```bash
# 1. 安装 Remote - SSH 插件（Ctrl + Shift + X）

# 2. SSH 连接服务器
ssh user@192.168.x.x

# 3. 进入项目目录
cd /home/你的项目

# 4. 开发操作
npm install
npm run dev

# 5. 本地访问
# 浏览器打开 http://服务器 IP:3000
```

### 5.3 WSL2 vs SSH 方式对比

| 特性 | WSL2 | SSH 到 Linux 服务器 |
|------|------|---------------------|
| 环境位置 | Windows 内 | 远程服务器 |
| 延迟 | 几乎无 | 有网络延迟 |
| 资源使用 | 本地电脑 | 服务器资源 |
| 便携性 | 随时可用 | 需要网络连接 |

---

## 六、Cursor 系统版与用户版区别

### 6.1 对比表

| 特性 | 系统版 (System) | 用户版 (User) |
|------|-----------------|---------------|
| 作用范围 | 当前操作系统用户 | 所有用户 |
| 安装位置 | `C:\Program Files\Cursor` | `C:\Users\用户名\AppData\Local\Programs\Cursor` |
| 设置同步 | 不随用户登录漫游 | 随用户账户漫游 |
| 管理员权限 | 需要 | 通常不需要 |
| 多用户电脑 | 所有用户共用配置 | 各用户独立配置 |

### 6.2 推荐选择

- **个人电脑**：用户版（User）
- **公司电脑/多用户**：系统版（System）

---

## 七、Cursor 连接 WSL 后的配置位置

### 7.1 配置读取规则

**重要：Cursor 连接 WSL 后，所有操作都基于 WSL 的 Linux 系统！**

| 项目 | 读取位置 |
|------|---------|
| 扩展插件 | WSL 里的版本（需重装） |
| Settings | WSL 的 `~/.cursor/` |
| Skills | WSL 里的配置 |
| MCP | WSL 里的配置 |
| 项目代码 | WSL 的文件系统 |
| 运行环境 | WSL 的 Linux 环境 |

### 7.2 注意事项

**Windows 本地的配置不生效：**
- ❌ 扩展不共用（需在 WSL 里重新安装）
- ❌ 快捷键、主题等需重新配置
- ❌ Skills、MCP 配置需要重新设置

**两边配置独立：**
- Windows 的 Cursor 配置 ≠ WSL 里的 Cursor 配置
- 需要维护两套配置

### 7.3 配置同步方案

如果需要同步配置，可以：

1. 将 `.cursor/` 目录链接到共享位置
2. 使用 Cursor 的 Settings Sync 功能
3. 使用版本控制管理配置文件

---

## 八、常见问题 FAQ

### Q1: WSL2 和虚拟机有什么区别？

WSL2 更轻量，启动快、资源占用少，与 Windows 集成度更高。虚拟机是完全独立的系统。

### Q2: Windows 和 WSL 的 Java 环境会冲突吗？

不会。Windows 的 Java 在 `C:\Program Files\Java`，WSL 的 Java 在 `/usr/lib/jvm`，两套完全独立。

### Q3: Cursor 连接 WSL 后还能用 Windows 的 MCP 吗？

不能。连接 WSL 后，所有的 MCP、Skills、扩展都读取 WSL 里的配置。

### Q4: 哪种方式更好？WSL 还是 SSH？

- **本地开发**：WSL2
- **远程服务器开发**：SSH

### Q5: WSL2 会影响 Windows 性能吗？

WSL2 按需使用内存，不会一直占用，性能接近原生 Linux。

---

## 九、总结

1. **系统选择**：Java/Go/Vue 开发推荐 Windows 11 Pro
2. **WSL2 定位**：轻量级 Linux 环境，与 Windows 集成紧密
3. **Cursor 连接**：通过官方 WSL 插件实现远程开发
4. **环境隔离**：Windows 和 WSL 的开发和运行环境完全独立
5. **配置管理**：连接 WSL 后需使用 WSL 内的配置和扩展

---

> 最后更新：2026 年 2 月