用途:在 Windows 10/11 上配置完整的 WSL2 跨平台开发环境,适用于新机器初始化、首次配置 WSL2、为已有 WSL 补充开发工具,以及搭建 WSL 与 Windows 工具协同的工作流。
主要能力与步骤:
- 安装 WSL2:在管理员 PowerShell 中执行 wsl --install 与 wsl --set-default-version 2,默认安装 Ubuntu。
- 资源限制:在 Windows 用户主目录创建 ~/.wslconfig,设置 [wsl2] 下的 memory、processors、localhostForwarding,执行 wsl --shutdown 后生效。
- 安装基础工具:sudo apt update && sudo apt upgrade -y,并安装 build-essential、curl、wget、git、git-lfs、vim、htop、tree、jq、ripgrep、fd-find、unzip、zip 等。
- 配置 Git:设置 user.name、user.email、init.defaultBranch main、core.autocrlf input、color.ui auto、core.editor vim。
- SSH 密钥:用 ssh-keygen -t ed25519 生成密钥,启动 ssh-agent 并 ssh-add,将公钥添加到 GitHub,用 ssh -T git@github.com 验证。
- Node.js:通过 nvm 安装脚本安装,再执行 nvm install --lts 与 nvm use --lts。
- Python:安装编译依赖后通过 pyenv.run 安装 pyenv,配置 PATH 与初始化,再 pyenv install 3.12 并设为 global。
- Shell 配置:在 ~/.bashrc 中设置历史记录变量、导航别名(ll、la、..、...)、DEV_HOME 与 dev 别名、mkcd 函数及 PATH。
- Claude Code CLI:将 ~/.claude/local/node_modules/.bin 加入 PATH,用 which claude 验证。
- 跨平台路径:Windows 的 C:\Users\Name 对应 /mnt/c/Users/Name,D:\dev\projects 对应 /mnt/d/dev/projects,可用 explorer.exe . 打开资源管理器。
限制与注意事项:/mnt/ 下文件访问较慢,常用项目建议放在 WSL 文件系统;core.autocrlf=input 可避免换行符问题;/mnt/ 文件权限可能异常,可在 /etc/wsl.conf 配置 automount 选项;可将 WSL 目录排除出 Windows Defender 实时扫描以提升性能。资料未提供具体收费、价格或效果数据。