WSL安装及WSL Linux环境常用配置手册

发表于 更新于 本文字数： 1.4k 阅读时长 ≈ 5 分钟
介绍Windows上安装WSL及配置WSL虚拟机的基本方法

WSL安装方式

  1. 安装方式

    1
    2
    3
    4
    5
    # 根据实际情况修改参数
    # -d指定发行版本名称
    # --name设置虚拟机实例名称，实例名称不可重复
    # --location设置虚拟机安装位置，注意创建目录
    wsl --install -d Ubuntu-26.04 --name Ubuntu-26.04 --location D:\wsl\Ubuntu

  2. 打开WSL Settings软件，网络-网络模式设置为Mirrored，这样的话WSL中虚机和主机共享一个网络

  3. 其他常用命令

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    # 查看当前有哪些虚拟机及状态
    wsl -l -v

    # 运行指定名称的虚拟机
    wsl -d <name>

    # 备份虚拟机，根据实际情况修改导出位置，注意创建目录
    wsl --export Ubuntu-26.04 D:\wsl\snapshot\ubuntu-26.04-snapshot-202606082220.tar

    # 从备份恢复，第一个位置为虚机文件位置，第二个为备份文件位置，注意创建目录
    wsl --import Ubuntu-26.04-test D:\wsl\ubuntu-test D:\wsl\snapshot\ubuntu-26.04-snapshot-20260608.tar

    # 删除指定名称的虚拟机
    wsl --unregister <name>

Linux常见工具安装及配置方式

其他Linux系统初始化也可以参考。

建议安装配置

安装常用的软件

1
2
3
4
5
# 更新apt源
sudo apt update

# 安装以下常用软件
sudo apt install plocate zip net-tools telnet python3.14-venv pipx

设置默认语言环境

否则带有中文的文件名输出会乱码。

1
2
sudo locale-gen en_US.UTF-8
sudo update-locale LANG=en_US.UTF-8

安装bun

bun是目前最流行最快的JavaScript包管理工具。

1
curl -fsSL https://bun.sh/install | bash

使用source ~/.bashrc或退出重新进入虚机，输入bun -v可看到输出版本号即说明安装成功。

安装uv

uv是目前最流行最快的Python包管理工具。

1
curl -LsSf https://astral.sh/uv/install.sh | sh

使用source ~/.bashrc或退出重新进入虚机，输入uv --version可看到输出版本号即说明安装成功。

安装nvm

nvm是node.js多版本管理工具。

1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.6/install.sh | bash

注意根据需要修改以上脚本中的版本号，最新版本可参见https://github.com/nvm-sh/nvm

使用source ~/.bashrc或退出重新进入虚机，输入nvm --version可看到输出版本号即说明安装成功。

设置pip、uv镜像源

[可选，建议配置]

设置pip包镜像源为阿里云镜像源，可加速Python包下载速度，设置后同样适用于uv

1
2
3
mkdir ~/.pip

vim ~/.pip/pip.conf

在~/.pip/pip.conf中添加如下内容：

1
2
3
4
5
[global]
index-url = http://mirrors.aliyun.com/pypi/simple/

[install]
trusted-host=mirrors.aliyun.com

设置npm、bun镜像源

[可选，建议配置]

设置npm包镜像源为阿里云镜像源，可加速node.js包下载速度，设置后同样适用于bun

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

安装OpenCode

OpenCode是类似ClaudeCode、CodeX的开源平替工具

1
bun add -g opencode-ai

输入opencode -v可看到输出版本号即说明安装成功。

配置OpenCode大模型

使用opencode命令进入OpenCode，输入/connect选择大模型供应商，配置API Key即可使用。

OpenCode同样提供OpenCode Go和OpenCode Zen大模型服务，这两个服务聚合力主流的大模型，可按需切换使用。OpenCode Go相对便宜，聚合了大量开源优质大模型；OpenCode Zen相对贵一些，聚合了大量闭源优质模型。可访问https://opencode.ai/了解更多。

安装oh-my-opencode插件

oh-my-opencode是OpenCode的增强插件。

打开OpenCode，粘贴如下内容并执行即可

1
2
Install and configure oh-my-opencode by following the instructions here:
https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md

安装MiniCode

MiMoCode是小米参考OpenCode开发的CLI工具，对中文支持友好。

1
curl -fsSL https://mimo.xiaomi.com/install | bash

使用source ~/.bashrc或退出重新进入虚机，输入mimo -v可看到输出版本号即说明安装成功。

可选配置

设置网络代理脚本

将以下脚本追加至~/.bashrc中，这样可以使用命令proxy_on开启代理，proxy_off关闭代理，proxy_status查看代理状态，也可以使用curl https://www.google.com测试是否代理生效。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# 开启代理 (默认地址为 http://127.0.0.1:7897，请根据你的实际情况修改)
proxy_on() {
    # 如果传入了参数，则使用传入的参数作为代理地址；否则使用默认地址
    local proxy_url=${1:-"http://127.0.0.1:7897"}

    export http_proxy="$proxy_url"
    export https_proxy="$proxy_url"
    export HTTP_PROXY="$proxy_url"
    export HTTPS_PROXY="$proxy_url"

    # 设置不走代理的本地地址 (非常重要，否则本地服务可能无法访问)
    export no_proxy="localhost,127.0.0.1,::1"
    export NO_PROXY="localhost,127.0.0.1,::1"

    echo "✅ 代理已开启: $proxy_url"
}

# 关闭代理
proxy_off() {
    unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY no_proxy NO_PROXY
    echo "❌ 代理已关闭"
}

# 查看当前代理状态
proxy_status() {
    if [ -n "$http_proxy" ]; then
        echo "🌐 当前代理状态: 已开启"
        echo "   代理地址: $http_proxy"
    else
        echo "🚫 当前代理状态: 未开启"
    fi
}

取消磁盘挂载

[WSL建议配置]

WSL默认会挂载主机上的磁盘至/mnt目录中，将以下脚本追加至~/.bashrc中可以取消默认挂载指定盘。如果不取消挂载，那么从WSL中会直接访问到主机文件，有误操作风险。WSL中安装了一些搜索软件（如plocate），因为挂载了主机上的磁盘文件，索引速度会变慢。如果没有必要，建议取消所有挂载。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 卸载主机磁盘
if mountpoint -q /mnt/c; then
    sudo umount /mnt/c;
fi

if mountpoint -q /mnt/d; then
    sudo umount /mnt/d;
fi

if mountpoint -q /mnt/e; then
    sudo umount /mnt/e;
fi

if mountpoint -q /mnt/f; then
    sudo umount /mnt/f;
fi

设置取消挂载免密，否则每次进入系统会要求输入密码，创建文件sudo vim /etc/sudoers.d/umount-wsl，文件内容如下：

1
2
# 增加如下内容，注意xxxx需要改为对应的用户名
xxxx ALL=(ALL) NOPASSWD: /usr/bin/umount