Windows 下安装 WSL2 及 OpenCode 教程

Linux/macOS 原生使用体验最稳、最省心；Windows 也能使用相关开发环境，但优先推荐 WSL2 或 Git Bash，原生体验略弱。

一、支持平台（官方）

1.  Linux（Ubuntu 18.04+/CentOS 7+）：原生支持、官方首选、无兼容问题
2.  macOS 10.15+：原生支持、体验流畅
3.  Windows 10/11：可运行，但非原生优先

二、选择 WSL2 的理由

1. 适配 Windows 日常使用场景：可正常使用办公软件（QQ、微信、Office 等）、浏览器、游戏、EXE 格式软件
2. 满足 Linux 开发需求：可运行 Python、搭建网站、部署数据库、运行 AI 程序、使用 OpenCode、模拟服务器环境等
3. WSL2 性能接近原生 Linux
4. Windows 与 Linux 环境可无缝互通文件
5. 安装 / 卸载过程简单，无需重启分区、不破坏原有系统

三、不同系统环境体验对比

四、安装建议

Windows 用户优先安装 WSL2 + Ubuntu，体验最接近 Linux，使用过程几乎无坑。

五、WSL2 安装步骤

5.1 一键安装（优先尝试）

1. 打开开始菜单，搜索「Windows PowerShell」
2. 右键点击 PowerShell，选择「以管理员身份运行」
3. 复制粘贴以下命令并回车执行：
   wsl –install

5.2 一键安装报错（error:0xc004000d）的修复方案

1. 以管理员身份打开 PowerShell：开始菜单 → 搜索「PowerShell」→ 右键 → 以管理员身份运行
2. 手动开启 WSL 必需的功能，依次执行以下两条命令：
   dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
   dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
3. 重启电脑（此步骤必须执行）
4. 重启后，执行指定版本安装命令：
   wsl –install -d Ubuntu
5. 设置 WSL 版本为 2：
   wsl –set-version Ubuntu 2

5.3 验证 WSL2 安装是否成功

1. 打开 PowerShell（无需管理员权限）
2. 输入以下命令：wsl -l -v
3. 若输出以下内容，说明安装成功：
   NAME           STATE           VERSION
   * Ubuntu         Running         2

六、OpenCode 安装步骤（需在 WSL 环境中执行）

6.1 进入 WSL Linux 环境

1. 打开 PowerShell
2. 输入以下命令并回车：
   wsl
3. 出现如下提示符，说明已进入 WSL 环境：
   你的名字@ubuntu:~$

6.2 更新系统（必须执行）

sudo apt update && sudo apt upgrade -y

6.3 安装 Node.js（OpenCode 依赖）

sudo apt install nodejs npm -y

6.4 安装 OpenCode

执行以下核心命令：

sudo npm install -g opencode

（若上述命令无效，可尝试：sudo npm install -g opencode-ai）

七、验证 OpenCode 安装是否成功

在 WSL 环境中输入以下命令：

opencode --version

若命令行显示版本号，说明安装成功。

八、启动 OpenCode（AI 编程助手）

在 WSL 环境中输入以下命令：

opencode