LiuMangMang/MyBlog
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(guide): 添加 WSL 开发指南文档并更新侧边栏

Browse Source 
- 新增 Cursor 连接 WSL 开发完整教程
- 添加 Windows 10/11 选择建议和 WSL2 详细说明
- 更新侧边栏添加开发工具分类
- 添加 SDKMAN 和 Jabba Java 版本管理文档
- 整理前端开发相关文档结构
This commit is contained in:
liumangmang
2026-02-04 11:14:25 +08:00
parent caae9fb69b
commit 9dda49b396
2 changed files with 9 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

328
src/programming/frontend/tools/Cursor-WSL开发指南.md Normal file
View File

@@ -0,0 +1,328 @@
---
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 月