尹灿宇
返回博客

WSL 环境崩溃后的重装与配置记录

记录一次 WSL 崩溃后的完整重装过程，以及开发环境的配置步骤。

2026-05-202 分钟阅读
WSLLinux开发环境踩坑

背景

某天 Windows 更新后，WSL 突然无法启动，报错 The Windows Subsystem for Linux instance has exited。

试了网上各种方法都没用，最后只能卸载重装。

重装步骤

1. 备份重要文件

# 从 Windows 资源管理器访问 WSL 文件
# \\wsl$\Ubuntu\home\longside

2. 卸载并重装

# PowerShell (管理员)
wsl --unregister Ubuntu
wsl --install -d Ubuntu-24.04

3. 恢复开发环境

# 安装基础工具
sudo apt update && sudo apt install -y git curl build-essential
 
# 安装 Node.js (via nvm)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install --lts
 
# 安装 Python
sudo apt install -y python3 python3-pip

教训

  1. 定期备份 dotfiles，不要等到崩溃再后悔
  2. WSL 的文件建议放在 Linux 侧（~/），不要在 /mnt/c/ 下操作
  3. 写一个部署脚本，一键恢复环境

下次再崩就不慌了 🫡