这篇文章是笔者真实的部署步骤 + 踩坑记录。

如果你是 Windows 用户、Cursor 用户、前端/AI 开发者， 这篇文章会帮你少走至少 3 天弯路。

你将学会：

• WSL 到底是什么？为什么程序员都在用它？
• 如何在 Windows 上搭建「像 Mac 一样舒服」的开发环境？
• 如何解决 C 盘爆炸、网络失败、代理失效、中文乱码等问题？
• 如何搭建 Node + Next.js + Cursor 的现代开发环境？

一、为什么我决定折腾 WSL？

事情的起点很简单：

• Cursor 终端中文乱码 ❌
• npm 安装慢 / 失败 ❌
• Linux 命令用不了 ❌
• Node 环境混乱 ❌
• 各种路径问题 ❌

我一度怀疑：

是不是 Windows 就不适合写代码？

后来我发现答案是：

❗不是 Windows 不行，而是你缺少 WSL。

二、WSL 是什么？一句话讲清楚

WSL（Windows Subsystem for Linux）：

在 Windows 上运行真正的 Linux 系统。

你可以理解为：

• 不是虚拟机 ❌
• 不是模拟器 ❌
• 是 Windows 官方 Linux 环境 ✅

那为什么我们不直接在VMware里面用真实的Ubuntu Linux系统呢？下面是WSL和VMware虚拟机的对比。

WSL vs 虚拟机（VMware）

结论：

💡 可见 WSL 在性能、启动速度、资源占用、与 Windows 系统联动性上均远优于 VMware 虚拟机，对程序员的适配性和友好度更是拉满，是程序员在 Windows 系统下使用 Linux 环境的最优选择，而虚拟机更适合普通用户的基础使用需求。

更重要的是：

以往我们用虚拟机需通过共享文件夹、手动传文件实现跨系统文件操作，繁琐且易出问题；现在 Windows 可直接在文件资源管理器访问 WSL 的 Linux 目录，Linux 也能直接操作 Windows 本地文件，跨系统编辑、传输文件直接就无感了啊，跟操作Windows一毛一样。

使用 WSL 是可以直接调用 Windows 的本地的软件的，也就是说在 Linux 环境下能直接打开、运行 Windows 端的各类程序，无需额外的兼容设置或跨环境调用工具。比如在 Linux 命令行中直接启动 VS Code、Cursor、微信、浏览器等常用软件，也能调用 Office、画图工具等办公设计类程序。也能在 Linux 环境中无缝使用 Windows 的网络、硬件资源，再也不用为虚拟机单独配置网络桥接、硬件分配，这样直接降低了我们使用门槛，节省了大量的配置环境的时间。

使用 WSL 可以直接把 Windows 下的编辑器当作 Linux 的开发工具，也就是说在 VS Code、Cursor 这些常用编辑器里，能直接连接 WSL 作为开发环境，无需在两个系统间来回切换、同步代码。比如在编辑器里写完代码，直接就能调用 WSL 的 Linux 环境运行、调试，代码编写、运行、调试在同一界面完成，跟在 Windows 本地开发一样。

使用 WSL 可以一键部署多个 Linux 开发环境，也就是说在 Windows 上能直接一键安装、卸载 Ubuntu、CentOS、Debian 等不同的 Linux 发行版，无需单独分配磁盘空间、配置虚拟硬件。而且各发行版相互独立、互不干扰，占用的磁盘和内存资源远低于虚拟机，完全不拖累 Windows 主机运行，日常使用起来轻便又省心。

三、WSL 安装：现实 vs 教程

理论上，你只需要一句命令：

wsl --install

但现实是：

❌ 坑 1：403 被拒绝

已禁止(403)

❌ 坑 2：WSL Update 失败

Windows Subsystem for Linux Update Setup Wizard ended prematurely

❌ 坑 3：系统说没安装 WSL

但你明明启用了功能。

✅ 解决方案（真实过程）

检查系统功能：

dism.exe /online /get-featureinfo /featurename:Microsoft-Windows-Subsystem-Linux
dism.exe /online /get-featureinfo /featurename:VirtualMachinePlatform

更新 WSL：

wsl --update
wsl --set-default-version 2

安装 Ubuntu：

wsl --install -d Ubuntu

那一刻，我第一次看到 Linux 终端：

wyf@WYF:~$

感觉像打开了新世界的大门。

四、C 盘爆炸：我最先后悔的事

WSL 默认安装在 C 盘。

结果：

😱 C 盘空间肉眼可见地减少。

✅ 把 Ubuntu 迁移到 D 盘

导出：

wsl --export Ubuntu D:\wsl\ubuntu.tar

删除原系统：

wsl --unregister Ubuntu

导入到 D 盘：

wsl --import Ubuntu D:\wsl\Ubuntu D:\wsl\ubuntu.tar --version 2

从此：

✅ Linux 完全运行在 D 盘

五、最痛苦的阶段：WSL 无法联网

当我运行：

sudo apt update

看到的是：

Temporary failure resolving 'archive.ubuntu.com'

那一刻我真的怀疑人生。

❌ 我尝试过的错误方法

1）改 DNS

nameserver 1.1.1.1
nameserver 8.8.8.8

结果：没用 ❌

2）ping google

100% packet loss

3）我明明开了科学上网

但 WSL 完全不认。

六、真正的真相：WSL ≠ Windows

在 Windows 中：

• 代理地址：127.0.0.1

但在 WSL 中：

❗127.0.0.1 不是 Windows，而是 Linux 自己！

这是我整个过程最大的突破。

七、找到 Windows IP（关键一步）

ip route | grep default

输出：

default via 172.31.48.1

这一行，就是 Windows 在 WSL 里的真实 IP。

八、第一次成功联网（爽感时刻）

export http_proxy="http://172.31.48.1:7897"
export https_proxy="http://172.31.48.1:7897"
export all_proxy="socks5://172.31.48.1:7897"

测试：

curl google.com -I

当看到 HTTP 响应时，我真的想鼓掌：

🎉 原来是这么回事！

九、让代理永久生效（自动化）

编辑 ~/.bashrc：

nano ~/.bashrc

加入：

# ===== WSL Proxy =====
WIN_IP=$(ip route | awk '/default/ {print $3}')
export http_proxy="http://$WIN_IP:7897"
export https_proxy="http://$WIN_IP:7897"
export all_proxy="socks5://$WIN_IP:7897"
# =====================

生效：

source ~/.bashrc

十、Cursor 终端中文乱码解决

首先，当你打开linux项目时，Cursor左下角就会显示是否安装WSL拓展，这时候一定要选择安装！安装结束后重启Cursor，这时候你的终端区域就全变成linux下的命令了！

然后就能解决中文乱码的问题：

安装中文语言包：

sudo apt install -y language-pack-zh-hans
sudo locale-gen zh_CN.UTF-8

设置语言：

echo 'export LANG=zh_CN.UTF-8' >> ~/.bashrc
echo 'export LC_ALL=zh_CN.UTF-8' >> ~/.bashrc
source ~/.bashrc

从此：

✅ Cursor 终端中文完美显示

十一、安装 Node.js（现代开发必备）

安装 nvm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc

安装 Node：

nvm install 24
node -v
npm -v

十二、创建 Next.js 项目

mkdir ~/projects
cd ~/projects
npx create-next-app my-app
cd my-app
npm run dev

浏览器访问：

http://localhost:3000

那一刻你会意识到：

💥 Windows 终于变成了 Mac。

十三、WSL + Cursor 架构图（核心理解）

Windows
 ├─ Cursor / VSCode
 ├─ 科学上网
 └─ WSL2
      ├─ Ubuntu
      ├─ Node / npm / Next.js
      └─ 代理 → Windows IP → 科学上网

十四、真正学到的，不只是技术

你只是缺一套正确的环境。

WSL 对我来说，不只是工具，而是：

🧠 Windows 程序员的第二次觉醒。

十五、如果你也想搭建这套环境

你只需要记住一句话：

✅ 不要怕命令行，所有大佬都从这里开始。

如果你觉得这篇文章有用，欢迎收藏。

—— 完 ——

阅读原文：原文链接