Windows 11 安装 WSL + Debian + OpenCode 完整指南
本指南每一步都有详细说明，请按照顺序操作。第一部分：在 Windows 11 中启用并安装 WSL步骤 1：启用 WSL 功能打开设置按下键盘上的 Windows 键（就是键盘上那个带有Windows标志的键）点击右下角的「设置」图标（齿轮形状）或者直接按 Windows + i 快捷键打开设置进入应用和功能在设置界面中，找到并点击「应用」然后点击「应用和功能」启用 WSL滚动到页面最下方，点击「程序和功能」（需要管理员权限）如果弹出用户账户控制窗口，点击「是」在弹出的窗口中，点击「启用或关闭 Windows 功能」向下滚动，找到「适用于 Linux 的 Windows 子系统」，勾选它找到「虚拟机平台」，也勾选它点击「确定」重启电脑重启完成后，WSL 就安装好了步骤 2：安装 WSL 2（推荐，比 WSL 1 更快）下载 WSL 2 更新包打开浏览器（Edge 或 Chrome）访问：https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi点击「下载」下载完成后，双击下载的文件 wsl_update_x64.msi按提示点击「下一步」直到安装完成将 WSL 2 设为默认版本按 Windows + R，打开运行窗口输入 cmd，按回车在打开的命令提示符窗口中输入以下命令，然后按回车：wsl --set-default-version 2第二部分：在 WSL 中安装 Debian 系统步骤 1：安装 Debian打开 Microsoft Store按 Windows 键，搜索「Microsoft Store」，打开它搜索 Debian在 Store 上方的搜索框中输入「Debian」在搜索结果中找到「Debian」应用（图标是一个蓝色的小房子）点击「获取」或「安装」安装 Debian下载完成后，点击「打开」或按「启动」第一次启动可能需要等待几分钟初始化当提示「Installing...」时，耐心等待，不要关闭窗口创建用户账号安装完成后，会提示你创建用户名输入一个英文名字（不要用中文），比如 debianuser，按回车输入密码（记住这个密码，后面会用到），按回车再次输入密码确认，按回车安装完成后，你将看到类似 debianuser@你的电脑名:~$ 的提示符步骤 2：验证 Debian 是否安装成功检查 WSL 版本打开命令提示符（按 Windows + R，输入 cmd，回车）输入以下命令：wsl --list --verbose应该能看到 Debian，显示版本号是 2第三部分：将 Debian 系统移动到 D 盘默认情况下，WSL 安装在 C 盘。为了不占用 C 盘空间，我们可以把它移到 D 盘。步骤 1：备份现有 Debian导出 Debian打开命令提示符（管理员模式）按 Windows + S，搜索「命令提示符」右键点击「命令提示符」，选择「以管理员身份运行」输入以下命令（把 你的用户名 改成你的 Windows 用户名）：wsl --export Debian D:\debian-backup.tar等待导出完成，这可能需要几分钟步骤 2：在 D 盘创建 WSL 文件夹打开 D 盘打开「此电脑」（桌面上的计算机图标）点击 D 盘在空白处右键 → 新建 → 文件夹将文件夹命名为 WSL（注意大小写）步骤 3：导入 Debian 到 D 盘注销原有的 Debian在命令提示符中输入：wsl --unregister Debian注意：这会删除原有的 Debian，但我们在 D 盘有备份，不用担心导入 Debian 到 D 盘输入以下命令：wsl --import Debian D:\WSL\Debian D:\debian-backup.tar --version 2验证移动是否成功输入：wsl --list --verbose看到 Debian 的安装位置变成 D:\WSL\Debian 就成功了清理备份文件可以删除 D:\debian-backup.tar 文件，释放空间第四部分：在 Debian 中安装配置 OpenCode步骤 1：打开 Debian 终端启动 Debian按 Windows 键，搜索「Debian」，打开它或者在命令提示符中输入 wsl，直接进入 WSL步骤 2：更新 Debian 系统更新软件源在终端中输入以下命令，按回车：sudo apt update输入你之前设置的密码（输入时不会显示，输入完按回车）等待更新完成升级已安装的软件输入：sudo apt upgrade -y输入 y 确认，等待升级完成（可能需要较长时间）步骤 3：安装必要的软件安装 curl 和 git输入：sudo apt install curl git -y步骤 4：安装 OpenCode下载并安装 OpenCode输入以下命令：curl -fsSL https://get.opencode.ai | sh按照提示操作安装过程中会有一些提示，阅读后按回车继续如果询问，输入 y 确认验证安装安装完成后，输入：opencode --version如果显示版本号，说明安装成功步骤 5：配置 OpenCode（可选）初始化配置输入：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: 需要重置密码：在 Windows 命令提示符中输入 wsl -u root输入 passwd 你的用户名设置新密码结语恭喜你！现在已经成功在 Windows 11 中安装了 WSL + Debian，并将系统移动到了 D 盘，同时安装好了 OpenCode。有任何问题，请查阅常见问题解答，或在 OpenCode 中寻求帮助。祝使用愉快！