wsl2内核需升级至5.10+以支持dockerd，通过微软官网下载wsl_update_x64.msi安装并执行wsl --shutdown；vscode提示command 'remote-wsl.reopeninwsl' not found需确保wsl2默认发行版为ubuntu等白名单名称；git中文乱码应配置core.autocrlf input和core.precomposeunicode false，并确认locale为utf-8；python调试找不到解释器须在launch.json中显式指定wsl2内python路径。
WSL2内核版本太低导致dockerd启动失败
WSL2默认内核可能停留在旧版（比如5.4.x），而Docker Desktop或手动安装的dockerd要求至少5.10+。现象是运行sudo dockerd时卡住，或报错failed to start daemon: kernel version not supported。
解决办法不是升级整个Windows，而是单独更新WSL2内核：
- 访问 微软官方内核更新页，下载最新
wsl_update_x64.msi - 双击安装（无需重启，但需执行
wsl --shutdown再重启发行版） - 验证：
uname -r应输出类似5.15.133.1-microsoft-standard-WSL2
VSCode远程连接WSL2时提示command 'remote-wsl.reopenInWsl' not found
这不是插件没装，而是VSCode没识别到已安装的WSL2发行版——常见于从PowerShell用wsl --install后未手动启动过任意发行版，或安装了多个发行版但默认未设为Ubuntu（VSCode Remote-WSL插件默认只扫描Ubuntu、Debian等白名单名）。
检查并修复步骤：
- 在PowerShell中运行
wsl -l -v，确认状态为Running且名称是Ubuntu这类标准名；如果不是，用wsl --set-default <code>your-distro-name设为默认 - 确保已安装
Remote - WSL扩展（ID：ms-vscode-remote.remote-wsl），且未被工作区禁用 - 关闭所有VSCode窗口，再从PowerShell执行
code .（不是从VSCode里按Ctrl+P输命令）
git在WSL2中中文路径乱码或core.autocrlf失效
Windows Git和WSL2 Git混用时，文件路径编码、换行符策略容易冲突。典型表现：在VSCode里看到中文文件名显示为???.txt，或git status反复提示CRLF改动。
关键不是改Windows Git配置，而是让WSL2内的Git“只管Linux那一套”：
- 在WSL2终端中执行：
git config --global core.autocrlf input（Linux下统一用LF，不转换） - 禁止Git处理Windows路径编码：
git config --global core.precomposeUnicode false - 如果仍乱码，检查WSL2 locale：运行
locale，确保LANG含UTF-8（如en_US.UTF-8）；若无，编辑/etc/wsl.conf加入[boot] systemd=true并重装发行版（简单做法是删掉重装）
VSCode调试Python时launch.json找不到python解释器
WSL2里装了python3，但VSCode调试器仍报Python interpreter not found，本质是VSCode没把WSL2里的python3路径纳入搜索范围，尤其当用户用pyenv或conda管理环境时更明显。
直接指定路径比自动探测可靠：
- 在WSL2中运行
which python3，得到类似/home/username/.pyenv/shims/python的路径 - 在VSCode的
.vscode/launch.json中，显式写死python字段："python": "/home/username/.pyenv/shims/python"
- 如果用conda环境，路径通常是
/home/username/miniconda3/envs/myenv/bin/python，同样填入即可 - 注意：不要用Windows路径（如
C:\Users\...），VSCode Remote-WSL模式下所有路径必须是WSL2内路径
WSL2和VSCode的集成看似开箱即用，但真正稳定用起来，得亲手调过内核、认过发行版名、锁死解释器路径——这些点不在文档首页，却决定你能不能在周末安心写代码而不是查日志。
