window11.png

本指南每一步都有详细说明，请按照顺序操作。

第一部分：在 Windows 11 中启用并安装 WSL

步骤 1：启用 WSL 功能

  1. 打开设置

    • 按下键盘上的 Windows 键（就是键盘上那个带有Windows标志的键）
    • 点击右下角的「设置」图标（齿轮形状）
    • 或者直接按 Windows + i 快捷键打开设置

  2. 进入应用和功能

    • 在设置界面中，找到并点击「应用」
    • 然后点击「应用和功能」

  3. 启用 WSL

    • 滚动到页面最下方，点击「程序和功能」（需要管理员权限）
    • 如果弹出用户账户控制窗口，点击「是」
    • 在弹出的窗口中，点击「启用或关闭 Windows 功能」
    • 向下滚动，找到「适用于 Linux 的 Windows 子系统」，勾选它
    • 找到「虚拟机平台」，也勾选它
    • 点击「确定」

  4. 重启电脑

    • 重启完成后，WSL 就安装好了

步骤 2：安装 WSL 2（推荐，比 WSL 1 更快）

  1. 下载 WSL 2 更新包

  2. 将 WSL 2 设为默认版本

    • 按 Windows + R，打开运行窗口
    • 输入 cmd，按回车

    • 在打开的命令提示符窗口中输入以下命令，然后按回车：

      wsl --set-default-version 2

第二部分：在 WSL 中安装 Debian 系统

步骤 1：安装 Debian

  1. 打开 Microsoft Store

    • 按 Windows 键，搜索「Microsoft Store」，打开它

  2. 搜索 Debian

    • 在 Store 上方的搜索框中输入「Debian」
    • 在搜索结果中找到「Debian」应用（图标是一个蓝色的小房子）
    • 点击「获取」或「安装」

  3. 安装 Debian

    • 下载完成后，点击「打开」或按「启动」
    • 第一次启动可能需要等待几分钟初始化
    • 当提示「Installing...」时，耐心等待，不要关闭窗口

  4. 创建用户账号

    • 安装完成后，会提示你创建用户名
    • 输入一个英文名字（不要用中文），比如 debianuser，按回车
    • 输入密码（记住这个密码，后面会用到），按回车
    • 再次输入密码确认，按回车
    • 安装完成后，你将看到类似 debianuser@你的电脑名:~$ 的提示符

步骤 2：验证 Debian 是否安装成功

  1. 检查 WSL 版本

    • 打开命令提示符（按 Windows + R，输入 cmd，回车）

    • 输入以下命令：

      wsl --list --verbose
    • 应该能看到 Debian，显示版本号是 2

第三部分：将 Debian 系统移动到 D 盘

默认情况下，WSL 安装在 C 盘。为了不占用 C 盘空间，我们可以把它移到 D 盘。

步骤 1：备份现有 Debian

  1. 导出 Debian

    • 打开命令提示符（管理员模式）

      • 按 Windows + S，搜索「命令提示符」
      • 右键点击「命令提示符」，选择「以管理员身份运行」

    • 输入以下命令（把 你的用户名 改成你的 Windows 用户名）：

      wsl --export Debian D:\debian-backup.tar
    • 等待导出完成，这可能需要几分钟

步骤 2：在 D 盘创建 WSL 文件夹

  1. 打开 D 盘

    • 打开「此电脑」（桌面上的计算机图标）
    • 点击 D 盘
    • 在空白处右键 → 新建 → 文件夹
    • 将文件夹命名为 WSL（注意大小写）

步骤 3：导入 Debian 到 D 盘

  1. 注销原有的 Debian

    • 在命令提示符中输入：

      wsl --unregister Debian
    • 注意：这会删除原有的 Debian，但我们在 D 盘有备份，不用担心

  2. 导入 Debian 到 D 盘

    • 输入以下命令：

      wsl --import Debian D:\WSL\Debian D:\debian-backup.tar --version 2

  3. 验证移动是否成功

    • 输入：

      wsl --list --verbose
    • 看到 Debian 的安装位置变成 D:\WSL\Debian 就成功了

  4. 清理备份文件

    • 可以删除 D:\debian-backup.tar 文件，释放空间

第四部分：在 Debian 中安装配置 OpenCode

步骤 1：打开 Debian 终端

  1. 启动 Debian

    • 按 Windows 键，搜索「Debian」，打开它
    • 或者在命令提示符中输入 wsl，直接进入 WSL

步骤 2：更新 Debian 系统

  1. 更新软件源

    • 在终端中输入以下命令，按回车：

      sudo apt update
    • 输入你之前设置的密码（输入时不会显示，输入完按回车）
    • 等待更新完成

  2. 升级已安装的软件

    • 输入：

      sudo apt upgrade -y
    • 输入 y 确认，等待升级完成（可能需要较长时间）

步骤 3：安装必要的软件

  1. 安装 curl 和 git

    • 输入：

      sudo apt install curl git -y

步骤 4：安装 OpenCode

  1. 下载并安装 OpenCode

    • 输入以下命令：

      curl -fsSL https://get.opencode.ai | sh

  2. 按照提示操作

    • 安装过程中会有一些提示，阅读后按回车继续
    • 如果询问，输入 y 确认

  3. 验证安装

    • 安装完成后，输入：

      opencode --version
    • 如果显示版本号，说明安装成功

步骤 5：配置 OpenCode（可选）

  1. 初始化配置

    • 输入：

      opencode configure
    • 按照提示进行配置

第五部分：日常使用小贴士

如何快速打开 Debian

  • 按 Windows 键，输入「Debian」，回车
  • 或者固定到任务栏：右键点击 Debian 图标 → 固定到任务栏

如何在 Windows 和 Debian 之间复制粘贴

  • 在 Debian 窗口中右键点击标题栏
  • 选择「属性」
  • 勾选「快速编辑模式」
  • 以后就可以用鼠标选中文字，按回车复制，右键粘贴

如何退出 Debian

  • 在终端中输入：

    exit

如何重启 Debian（如果卡住了）

  • 在 Windows 命令提示符中输入：

    wsl --shutdown
  • 然后重新打开 Debian

常见问题解答

Q: 安装 Debian 时提示「WslRegisterDistribution failed with error: 0x8007019e」

A: 说明没有启用 WSL 功能，回到第一部分，检查「步骤 1：启用 WSL 功能」是否完成。

Q: 移动系统后，Debian 打不开了

A: 尝试在 Windows 命令提示符中输入 wsl --shutdown，然后重新打开。

Q: 安装 OpenCode 时网络超时

A: 检查网络连接，或者多试几次。也可以尝试使用代理。

Q: 忘记了 Debian 的密码怎么办

A: 需要重置密码：

  1. 在 Windows 命令提示符中输入 wsl -u root
  2. 输入 passwd 你的用户名
  3. 设置新密码

结语

恭喜你！现在已经成功在 Windows 11 中安装了 WSL + Debian，并将系统移动到了 D 盘，同时安装好了 OpenCode。

有任何问题，请查阅常见问题解答，或在 OpenCode 中寻求帮助。

祝使用愉快！