WSL + VSCode + Git + Node.js 开发环境配置文档

以下是 完整 WSL 开发环境配置文档。

适用：Windows 10/11 + WSL2 + Ubuntu
用途：Hardhat / Node.js / Git 开发

🖥️ 1. Windows 配置 WSL：点击搜索打开 Ubuntu

1.1 安装 WSL2

# 以管理员运行 PowerShell
wsl --install

✅ 自动安装 WSL2 + Ubuntu（重启电脑）

1.2 设置 Ubuntu 为默认 WSL 发行版

wsl --set-default Ubuntu

1.3 创建快捷方式（可选）

• 打开 C:\Users\你的用户名\AppData\Roaming\Microsoft\Windows\Start Menu\Programs
• 新建快捷方式，目标：

  wsl -d Ubuntu
  

• 命名为 Ubuntu

✅ 现在你可以在 Windows 搜索 中输入 Ubuntu，点击打开 WSL！

🌐 2. WSL 镜像映射 Windows 网络（代理 + 互通）

2.1 设置代理（WSL 使用 Windows 代理）

# 1. 获取 Windows IP
export WINDOWS_HOST_IP=$(grep -oP '(?<=nameserver\ ).*' /etc/resolv.conf)

# 2. 设置代理（端口按你的工具改：Clash=7890, Nginx=8080）
export http_proxy=http://$WINDOWS_HOST_IP:7890
export https_proxy=http://$WINDOWS_HOST_IP:7890
export no_proxy=localhost,127.0.0.1

# 3. 永久设置（写入 ~/.bashrc）
echo "export WINDOWS_HOST_IP=\$(grep -oP '(?<=nameserver\ ).*' /etc/resolv.conf)" >> ~/.bashrc
echo "export http_proxy=http://\$WINDOWS_HOST_IP:7890" >> ~/.bashrc
echo "export https_proxy=http://\$WINDOWS_HOST_IP:7890" >> ~/.bashrc
echo "export no_proxy=localhost,127.0.0.1" >> ~/.bashrc
source ~/.bashrc

2.2 测试网络

curl -v https://www.google.com

✅ 如果返回 HTML，说明代理成功！

2.3 文件互通

🍺 3. 安装 Homebrew（Linux 包管理器）

3.1 安装依赖

sudo apt update
sudo apt install -y build-essential curl file git

3.2 安装 Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3.3 添加到 PATH

echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.bashrc
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"

3.4 测试

brew --version

✅ 输出：Homebrew 4.x.x

💡 常用命令：

• brew install wget：安装 wget
• brew install gh：安装 GitHub CLI

🔧 4. 安装 NVM 和 Node.js

4.1 安装 NVM（Node.js 版本管理器）

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc

4.2 安装 Node.js（推荐 18.x LTS）

nvm install 18
nvm use 18
nvm alias default 18

4.3 验证

node --version  # v18.x.x
npm --version   # 9.x.x

4.4 配置 npm 镜像（加速下载）

npm config set registry https://registry.npmmirror.com

💡 常用命令：

• nvm install 20：安装 Node.js 20
• nvm use 18：切换版本
• npm init -y：创建 Node.js 项目

💻 5. 使用 Windows VSCode 开发 WSL

5.1 在 Windows 安装 VSCode

• 下载：https://code.visualstudio.com/

5.2 安装 “Remote - WSL” 插件

• VSCode 插件市场搜索：Remote - WSL → 安装

5.3 连接到 WSL

5.4 安装插件（在 WSL 内安装）

• ESLint（代码检查）
• Prettier（代码格式化）
• GitLens（Git 增强）
• Node.js（Node 开发）
• Hardhat（搜索 “Hardhat” 插件）
• Solidity（如果开发合约）

5.5 设置默认终端

• VSCode 中按 Ctrl+Shift+P → 输入 Terminal: Select Default Profile
• 选择 Ubuntu (WSL)

🔑 6. Git 配置（WSL 内独立安装）

6.1 安装 Git

sudo apt install -y git

6.2 配置 Git 用户

git config --global user.name "你的GitHub用户名"
git config --global user.email "你的邮箱@example.com"

6.3 生成 SSH 密钥（登录 GitHub）

ssh-keygen -t ed25519 -C "你的邮箱@example.com" -f ~/.ssh/github_id_ed25519
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/github_id_ed25519

6.4 复制公钥到 GitHub

cat ~/.ssh/github_id_ed25519.pub

• 登录 GitHub → Settings → SSH and GPG keys → New SSH key → 粘贴

6.5 测试 SSH

ssh -T git@github.com

✅ 成功输出：Hi 用户名! You've successfully authenticated...

📌 常用命令速查表

✅ 配置完成！

你现在拥有：

• ✅ Windows 搜索打开 WSL
• ✅ WSL 使用 Windows 代理 + 文件互通
• ✅ Homebrew 管理 Linux 包
• ✅ NVM 管理 Node.js 版本
• ✅ VSCode 远程开发 WSL
• ✅ Git + SSH 登录 GitHub