WSL2 + Linux + VS Code 远程开发入门教程

4. 安装常用工具（示例：git、编译工具、python）：

sudo apt install git build-essential python3 python3-pip -y

小提示：Windows 的 C: 驱动器在 WSL 里路径是 /mnt/c，例如 C:\Users\你 在 WSL 为 /mnt/c/Users/你。为了更好性能，建议把代码放在 WSL 的家目录（~）里。

六、用 VS Code 在 WSL 里开发（推荐）

1. 在 Windows 上安装 VS Code（从官网下载安装程序）。
2. 在 VS Code 中安装扩展：Remote - WSL。
3. 在 WSL 终端进入项目目录并执行：

cd ~/myproj code .

• code . 会在 Windows 的 VS Code 中打开该目录，但 VS Code 会以'连接到 WSL'的方式运行扩展与终端。此时你的编辑器、终端和调试都在 Linux 环境下工作（工具依赖都安装在 WSL）。

优点：几乎不用配置，体验接近原生 Linux。

七、用 VS Code 远程 SSH（当你要连接远程开发板或服务器时）

当你未来需要连到学校/公司/家中的远程 Linux（比如树莓派、开发板、远程服务器），可以使用 VS Code 的 Remote - SSH 扩展。基本步骤：

1. 在 Windows 上安装 VS Code 并安装 Remote - SSH 扩展。
2. 生成 SSH 密钥（在 Windows 的 PowerShell 或 WSL 都可以）：

ssh-keygen -t ed25519 -C "your_email@example.com"
# 回车使用默认路径（会生成 ~/.ssh/id_ed25519 和 id_ed25519.pub）

3. 把公钥内容（~/.ssh/id_ed25519.pub）复制到远程主机的 ~/.ssh/authorized_keys（远程主机需要能 SSH 登录）。可以用 ssh-copy-id（在 WSL 下可用）或手动拷贝：

# 在 WSL 下： ssh-copy-id user@remote-host 
# 或者手动复制公钥内容到远端 ~/.ssh/authorized_keys

4. 在 VS Code 的 Remote-SSH 面板中配置主机（或者直接通过扩展的命令 Remote-SSH: Connect to Host...），连接成功后即可像本地一样编辑、运行和调试远程文件。

八、常见问题与快速排查

• wsl --install 报错或失败：确认你用的是 Windows 11，且以管理员权限运行 PowerShell。必要时手动启用 Windows 功能（Virtual Machine Platform、Windows Subsystem for Linux）。
• VS Code Remote-SSH 连接失败：检查公钥是否已经追加到远程 ~/.ssh/authorized_keys，并且远程 ~/.ssh 权限为 700，authorized_keys 权限为 600。
• 文件读写/性能慢：这个很重要：把代码放在 WSL 的家目录（~）而不是 C: 驱动器下。WSL2 在文件系统交互上会比直接访问 C: 快很多。
• 找不到 code 命令：在 Windows 的 VS Code 里按 Ctrl+Shift+P，输入 Shell Command: Install 'code' command in PATH（如果没有看到，用 VS Code 的安装说明手动添加）。注意：打开 WSL 的终端时，VS Code 的 Remote - WSL 扩展通常会自动处理 code 命令。

九、练习清单（按顺序做）

1. 管理员 PowerShell 执行 wsl --install 并重启。完成后打开 Ubuntu，创建 Linux 用户。
2. 在 Ubuntu 里运行 sudo apt update && sudo apt upgrade -y。
3. 安装 git 并验证 git --version。
4. 在家目录创建项目：mkdir ~/hello-wsl && cd ~/hello-wsl，写个小脚本 echo 'print("hello from python")' > hello.py，运行 python3 hello.py。
5. 在 Windows 安装 VS Code，添加 Remote - WSL 扩展；在 WSL 里 cd ~/hello-wsl，运行 code . 并在 VS Code 里运行脚本。
6. 如果有远程 Linux 设备，生成 SSH 密钥并用 Remote-SSH 连接一次。

十、速查表（常用命令）

# Windows (管理员 PowerShell)
wsl --install
wsl -l -v
wsl --set-version <DistributionName> 2

# WSL / Ubuntu
sudo apt update && sudo apt upgrade -y
sudo apt install git build-essential python3 python3-pip -y
pwd
ls -la
cd ~/myproj
nano file

# SSH (生成密钥)
ssh-keygen -t ed25519 -C "[email protected]"
ssh-copy-id user@remote-host