WSL 安装 Debian 完全指南 🐧

Windows WSL

🚀 在 Windows 上无缝运行完整的 Debian Linux 环境，享受双系统的最佳体验

✨ WSL 与 Debian 结合的优势

  • ⚡ 接近原生性能: WSL 2 提供完整的 Linux 内核，性能接近原生 Linux
  • 🎯 开发友好: 完美支持各种开发环境和工具链
  • 🔄 无缝集成: 在 Windows 和 Linux 之间轻松共享文件和资源
  • 📦 生态丰富: 访问 Debian 庞大的软件仓库
  • 🛡️ 安全隔离: Linux 环境与 Windows 系统隔离，互不干扰
  • 💾 资源高效: 比传统虚拟机更轻量，启动更快

📖 目录导航

🔧 一、启用 WSL 功能

1. 系统要求检查

在开始之前，请确保您的系统满足以下要求：

  • Windows 10 版本 2004 及更高版本（Build 19041 及以上）或 Windows 11
  • 64 位操作系统
  • 虚拟化功能已在 BIOS/UEFI 中启用

2. 启用 WSL 功能

以管理员身份打开 PowerShell，运行以下命令：

1
2
3
4
5
6
7
8
9
10
11
# 启用 Linux 子系统功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 启用虚拟机平台功能
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 设置 WSL 2 为默认版本
wsl --set-default-version 2

# 验证 WSL 版本
wsl --version

3. 安装 WSL 2 Linux 内核更新包

访问 Microsoft WSL 文档 下载并安装最新的 WSL 2 Linux 内核更新包。

4. 重启电脑

完成上述步骤后，必须重启电脑以确保所有功能生效。

1
2
# 重启计算机
Restart-Computer

📦 二、安装 Debian

1. 安装方法选择

方法一：通过 Microsoft Store 安装（推荐）

  1. 打开 Microsoft Store
  2. 搜索 “Debian”
  3. 选择官方 Debian 应用并点击”获取”
  4. 安装完成后点击”启动”

方法二：通过命令行安装

1
2
3
4
5
6
7
8
# 查看可用的 Linux 发行版
wsl --list --online

# 安装 Debian
wsl --install -d Debian

# 或者指定发行版名称
wsl --install -d Debian --name debian

2. 首次设置 Debian

安装完成后，首次启动会提示创建用户账户：

1
2
# 自动启动 Debian 进行初始设置
debian.exe

按照提示输入新的 UNIX 用户名和密码。

💡 提示: 建议使用与 Windows 用户名不同的名称，以增强安全性。

3. 验证安装

1
2
3
4
5
6
# 查看已安装的 WSL 发行版
wsl -l -v

# 预期输出:
#   NAME      STATE           VERSION
# * Debian    Running         2
1
2
3
4
# 在 Debian 中查看系统信息
cat /etc/os-release
lsb_release -a
uname -a

🚀 三、基本操作和管理

1. 启动和关闭 Debian

1
2
3
4
5
6
7
8
9
10
11
12
13
# 启动 Debian
wsl -d Debian
# 或
debian.exe

# 在 Debian 中退出
exit

# 关闭所有 WSL 发行版
wsl --shutdown

# 终止特定发行版
wsl --terminate Debian

2. 文件系统交互

1
2
3
4
5
6
7
8
# 在 WSL 中访问 Windows 文件
cd /mnt/c/Users/YourUsername
ls /mnt/c/Users/

# 在 Windows 中访问 WSL 文件
# 文件资源管理器中输入：\\wsl$\Debian
# 或使用 PowerShell
explorer.exe "\\wsl$\Debian"

3. 软件包管理

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 更新软件包列表
sudo apt update

# 升级已安装的软件包
sudo apt upgrade -y

# 安装常用工具
sudo apt install -y curl wget git vim tree htop net-tools

# 搜索软件包
apt search package-name

# 查看软件包信息
apt show package-name

# 删除软件包
sudo apt remove package-name

# 清理不需要的包
sudo apt autoremove -y

4. 设置默认用户

1
2
3
4
5
6
7
8
# 查看当前默认用户
wsl -d Debian -- whoami

# 设置默认用户（替换 YourUsername 为您的用户名）
debian config --default-user YourUsername

# 或者通过修改 /etc/wsl.conf
sudo nano /etc/wsl.conf

添加以下内容：

1
2
[user]
default = YourUsername

⚙️ 四、高级配置

1. WSL 配置文件

创建或编辑 WSL 全局配置文件：

1
2
# 创建 WSL 配置文件
notepad $HOME\.wslconfig

添加以下内容（根据您的硬件调整）：

1
2
3
4
5
6
7
8
9
10
11
12
[wsl2]
memory=4GB                 # 限制内存使用，建议为物理内存的50-70%
processors=2               # 限制 CPU 核心数
swap=1GB                   # 交换空间大小
localhostForwarding=true   # 允许本地端口转发

# 内核设置（可选）
kernel=C:\\Users\\YourUsername\\kernel

# 网络设置（可选）
networkingMode=nat         # NAT 模式
ipv6=true                  # 启用 IPv6

2. Debian 特定配置

在 Debian 中编辑 WSL 配置文件：

1
sudo nano /etc/wsl.conf

添加以下内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
[automount]
enabled = true         # 启用自动挂载
root = /mnt/           # 挂载点根目录
options = "metadata,umask=22,fmask=11"  # 挂载选项
mountFsTab = true      # 启用 /etc/fstab 挂载

[network]
generateHosts = true   # 自动生成 /etc/hosts
generateResolvConf = true  # 自动生成 /etc/resolv.conf

[interop]
enabled = true         # 启用 Windows 互操作
appendWindowsPath = true  # 将 Windows PATH 添加到 Linux PATH

[user]
default = YourUsername  # 默认用户

3. 资源使用优化

1
2
3
4
5
6
7
8
9
10
11
12
# 清理包缓存
sudo apt clean
sudo apt autoclean

# 清理旧内核（如果有）
sudo apt autoremove --purge

# 查看磁盘使用情况
df -h

# 查看内存使用情况
free -h

🎯 五、开发环境配置

1. 基础开发工具

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 安装开发基础工具包
sudo apt install -y build-essential

# 安装 Python
sudo apt install -y python3 python3-pip python3-venv

# 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

# 安装 Java
sudo apt install -y default-jdk

# 安装 Ruby
sudo apt install -y ruby-full

# 安装 Go
sudo apt install -y golang-go

2. 容器和虚拟化

1
2
3
4
5
6
7
8
9
10
11
12
13
# 安装 Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

# 安装 Docker Compose
sudo apt install -y docker-compose

# 安装 Podman（Docker 替代品）
sudo apt install -y podman

# 安装 Kubernetes 工具
sudo apt install -y kubectl helm

3. 数据库安装

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 安装 PostgreSQL
sudo apt install -y postgresql postgresql-contrib

# 安装 MySQL
sudo apt install -y mysql-server mysql-client

# 安装 SQLite
sudo apt install -y sqlite3

# 安装 Redis
sudo apt install -y redis-server

# 安装 MongoDB
sudo apt install -y mongodb

4. Web 开发环境

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 安装 Nginx
sudo apt install -y nginx

# 安装 Apache
sudo apt install -y apache2

# 安装 PHP
sudo apt install -y php php-cli php-fpm php-mysql php-pgsql php-sqlite3

# 安装 Composer
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

# 安装 Let's Encrypt 客户端
sudo apt install -y certbot python3-certbot-nginx

5. 配置 SSH

1
2
3
4
5
6
7
8
9
10
11
# 生成 SSH 密钥
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

# 启动 SSH 服务
sudo service ssh start

# 设置开机自启
sudo systemctl enable ssh

# 复制公钥到剪贴板（在 Windows 中）
cat ~/.ssh/id_rsa.pub | clip.exe

6. 安装图形界面（可选）

1
2
3
4
5
6
7
8
9
10
11
12
# 安装 XFCE4 桌面环境
sudo apt install -y xfce4 xfce4-goodies xorg dbus-x11

# 安装远程桌面服务
sudo apt install -y xrdp

# 配置 xrdp
sudo sed -i 's/port=3389/port=3390/g' /etc/xrdp/xrdp.ini
sudo service xrdp restart

# 在 Windows 端安装 X11 服务器
# 从 https://sourceforge.net/projects/vcxsrv/ 下载并安装 VcXsrv

🔄 六、备份和恢复

1. 导出 WSL 发行版

1
2
3
4
5
6
7
8
# 创建备份目录
mkdir $HOME\wsl-backups

# 导出 Debian 系统
wsl --export Debian $HOME\wsl-backups\debian-backup.tar

# 导出特定版本（压缩）
wsl --export Debian $HOME\wsl-backups\debian-backup.tar --vhd

2. 导入 WSL 发行版

1
2
3
4
5
# 导入已有的备份
wsl --import Debian-new $HOME\WSL\Debian-new\ $HOME\wsl-backups\debian-backup.tar

# 指定 WSL 版本
wsl --import Debian-new $HOME\WSL\Debian-new\ $HOME\wsl-backups\debian-backup.tar --version 2

3. 迁移 WSL 到其他驱动器

1
2
3
4
5
6
7
8
9
10
11
# 导出发行版
wsl --export Debian $HOME\wsl-backups\debian-backup.tar

# 注销原发行版
wsl --unregister Debian

# 导入到新位置
wsl --import Debian D:\WSL\Debian\ $HOME\wsl-backups\debian-backup.tar

# 设置默认用户
debian config --default-user YourUsername

4. 定期备份脚本

创建 PowerShell 备份脚本：

1
2
3
4
5
6
7
8
9
10
11
12
# backup-wsl.ps1
$date = Get-Date -Format "yyyyMMdd"
$backupPath = "$HOME\wsl-backups\debian-$date.tar"

# 创建备份目录
New-Item -ItemType Directory -Force -Path "$HOME\wsl-backups"

# 导出 Debian
wsl --shutdown
wsl --export Debian $backupPath

Write-Host "备份已完成: $backupPath"

💡 七、实用技巧

1. Windows Terminal 集成

安装 Windows Terminal 后，在设置中添加 Debian 配置：

1
2
3
4
5
6
7
8
{
    "guid": "{07b52e3e-de2c-5db4-bd2d-ba144ed6c273}",
    "hidden": false,
    "name": "Debian",
    "source": "Windows.Terminal.Wsl",
    "startingDirectory": "//wsl$/Debian/home/YourUsername",
    "icon": "https://apps.microsoft.com/store/detail/debian/9MSVKQC78PK6/icon"
}

2. VS Code 与 WSL 集成

  1. 安装 VS Code
  2. 安装 Remote - WSL 扩展
  3. 在 WSL 中打开项目：
    1
    code .

3. 性能优化技巧

1
2
3
4
5
6
7
8
9
10
# 禁用不必要的服务
sudo systemctl disable --now apache2.service

# 使用 zram 压缩内存（如果需要）
sudo apt install -y zram-config

# 优化文件系统性能
# 在 /etc/wsl.conf 中添加：
[file]
umask = 022

4. 常用别名和函数

在 ~/.bashrc 中添加：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 快速切换到 Windows 目录
alias winhome="cd /mnt/c/Users/YourUsername"

# 在 Windows 资源管理器中打开当前目录
alias explorer="explorer.exe ."

# 复制文件内容到 Windows 剪贴板
alias clip="clip.exe"

# 快速重启 WSL
alias wsl-restart="wsl.exe --shutdown"

# 查看 WSL 状态
alias wsl-status="wsl.exe --list --verbose"

🛠️ 八、故障排除

1. 常见问题解决

1
2
3
4
5
6
7
8
9
10
11
12
13
# 如果 WSL 无法启动
wsl --shutdown
wsl -d Debian

# 重置 Debian
wsl --unregister Debian
wsl --install -d Debian

# 检查 WSL 状态
wsl --status

# 修复 WSL 2 问题
wsl --update

2. 网络问题解决

1
2
3
4
5
6
7
8
9
10
11
12
13
# 检查网络连接
ping google.com

# 查看 IP 配置
ip addr show
cat /etc/resolv.conf

# 重置网络
sudo service network-manager restart

# 手动设置 DNS
sudo nano /etc/resolv.conf
# 添加：nameserver 8.8.8.8

3. 文件权限问题

1
2
3
4
5
6
# 修复文件权限
sudo chown -R $USER:$USER ~/

# 修复 Windows 文件权限
sudo umount /mnt/c
sudo mount -t drvfs C: /mnt/c -o metadata,uid=1000,gid=1000,umask=22,fmask=111

4. 性能问题

1
2
3
4
5
6
7
8
9
# 查看系统资源使用
top
htop

# 检查磁盘 I/O
iotop

# 识别性能瓶颈
perf top

5. 启动问题

如果 Debian 无法启动，尝试：

1
2
3
4
5
6
7
8
9
# 检查日志
wsl -d Debian -- dmesg | tail -20

# 以 root 身份启动
wsl -d Debian -u root

# 修复损坏的包
sudo apt --fix-broken install
sudo dpkg --configure -a

📚 九、学习资源

1. 官方文档

2. 社区资源

3. 推荐书籍

  • “WSL 2: Tips, Tricks, and Techniques” by Stuart Leeks
  • “Debian Administrator’s Handbook” by Raphaël Hertzog and Roland Mas

4. 在线课程

5. 实用工具

🎉 总结

通过本指南，您已经成功在 Windows 上配置了完整的 Debian 开发环境。WSL 2 提供了接近原生 Linux 的性能，让您能够同时享受 Windows 的便利和 Linux 的强大功能。

✅ 已完成的任务：

  1. 环境准备: 启用 WSL 并安装必要组件
  2. 系统安装: 成功安装和配置 Debian
  3. 开发环境: 设置完整的开发工具链
  4. 优化配置: 调整系统以获得最佳性能
  5. 故障处理: 掌握常见问题的解决方法

🌟 后续建议：

  1. 探索更多 WSL 2 高级功能，如 GPU 加速和 systemd 支持
  2. 学习使用 Windows Terminal 的多标签和分屏功能
  3. 尝试在 WSL 中运行 Docker 和 Kubernetes
  4. 参与 Debian 社区，了解最新更新和最佳实践