WSL2 允许在 Windows 11 上运行 Linux 内核，适合嵌入式及脚本开发。本文介绍通过 wsl --install 快速安装 Ubuntu，掌握 sudo apt、ls、cd 等基础命令，并将代码存放于 WSL 家目录以获得最佳性能。同时演示如何在 VS Code 中配置 Remote - WSL 扩展实现本地开发，以及通过 Remote - SSH 连接远程服务器或开发板进行调试，提供常用命令速查表与常见问题排查指南。
本文面向对软件不熟、只会一点 PowerShell 的嵌入式硬件朋友。目标是：在 Windows 11 上安装并使用 WSL2，掌握常用 Linux 命令，并用 VS Code 做本地（WSL）和远程（SSH）开发。
WSL（Windows Subsystem for Linux）让你在 Windows 里运行真正的 Linux。对嵌入式开发、脚本、构建工具和很多开源工具来说，Linux 环境更为友好。WSL2 更接近真实的 Linux 内核，性能更好，推荐在 Windows 11 上使用 WSL2。
Windows Terminal (Admin) 或 PowerShell (Admin)）。wsl --install
这条命令会自动启用所需 Windows 功能、安装 WSL2（默认会安装 Ubuntu），并提示重启。重启后，首次启动 Ubuntu 时会要求你创建 Linux 的用户名和密码。
如果你使用的是最新版 Windows 11，
wsl --install通常是最简单的方式。
wsl -l -v
Ubuntu-22.04）：wsl --set-default <DistributionName>
wsl --set-version <DistributionName> 2
Ubuntu 应用。sudo apt update && sudo apt upgrade -y
pwd # 显示当前目录
ls -la # 列出当前目录文件（含隐藏）
cd ~ # 回到家目录
mkdir myproj # 新建文件夹
cd myproj
touch hello.c # 新建文件
nano hello.c # 用一个简单编辑器打开文件（不熟可以用 nano）
cat hello.c # 显示文件内容
sudo apt install git build-essential python3 python3-pip -y
小提示：Windows 的
C:驱动器在 WSL 里路径是/mnt/c，例如C:\Users\你在 WSL 为/mnt/c/Users/你。为了更好性能，建议把代码放在 WSL 的家目录（~）里。
cd ~/myproj code .
code . 会在 Windows 的 VS Code 中打开该目录，但 VS Code 会以'连接到 WSL'的方式运行扩展与终端。此时你的编辑器、终端和调试都在 Linux 环境下工作（工具依赖都安装在 WSL）。优点：几乎不用配置，体验接近原生 Linux。
当你未来需要连到学校/公司/家中的远程 Linux（比如树莓派、开发板、远程服务器），可以使用 VS Code 的 Remote - SSH 扩展。基本步骤：
Remote - SSH 扩展。ssh-keygen -t ed25519 -C "your_email@example.com"
# 回车使用默认路径（会生成 ~/.ssh/id_ed25519 和 id_ed25519.pub）
~/.ssh/id_ed25519.pub）复制到远程主机的 ~/.ssh/authorized_keys（远程主机需要能 SSH 登录）。可以用 ssh-copy-id（在 WSL 下可用）或手动拷贝：# 在 WSL 下： ssh-copy-id user@remote-host
# 或者手动复制公钥内容到远端 ~/.ssh/authorized_keys
Remote-SSH: Connect to Host...），连接成功后即可像本地一样编辑、运行和调试远程文件。wsl --install 报错或失败：确认你用的是 Windows 11，且以管理员权限运行 PowerShell。必要时手动启用 Windows 功能（Virtual Machine Platform、Windows Subsystem for Linux）。~/.ssh/authorized_keys，并且远程 ~/.ssh 权限为 700，authorized_keys 权限为 600。~）而不是 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 命令。wsl --install 并重启。完成后打开 Ubuntu，创建 Linux 用户。sudo apt update && sudo apt upgrade -y。git 并验证 git --version。mkdir ~/hello-wsl && cd ~/hello-wsl，写个小脚本 echo 'print("hello from python")' > hello.py，运行 python3 hello.py。cd ~/hello-wsl，运行 code . 并在 VS Code 里运行脚本。# 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
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online