Windows WSL2安装Ubuntu搭建开发环境教程，2023年5月更新

WSL2 子系统安装（Ubuntu）

​

查看发行版本

代码语言：javascript复制

wsl --list --online

简写：

代码语言：javascript复制

wsl -l -o

查看已安装版本

代码语言：javascript复制

wsl --list --verbose

简写：

代码语言：javascript复制

wsl -l -v

安装指定版本

代码语言：javascript复制

wsl --install Ubuntu-22.04

等待安装成功，等待几分钟启动系统。

设置用户名：deshun，设置密码：0000，重复输入密码。

代码语言：javascript复制

Installing, this may take a few minutes...
Please create a default UNIX user account. The username does not need to match your Windows username.
For more information visit: https://aka.ms/wslusers
Enter new UNIX username: deshun
Enter new UNIX password:
Retype new UNIX password:
passwd: password updated successfully
Installation successful!
To run a command as administrator (user "root"), use "sudo <command>".
See "man sudo_root" for details.

进入 WSL 子系统

直接在终端输入命令 wsl 启动：

代码语言：javascript复制

wsl

win q 搜索 wsl 会显示入口，点击进入。

用 vscode 通过 wsl 打开 D 盘中的代码：

代码语言：javascript复制

cd /mnt/d/code/w3h5.com # 进入项目目录
code . # 通过vs code打开项目

注意：执行 code . 没反应，需要 以管理员身份运行 终端。

修改 WSL 子系统默认用户

代码语言：javascript复制

<DistributionName> config --default-user <Username>

更改用于发行版登录的默认用户。 用户必须已经存在于发行版中才能成为默认用户。

例如：ubuntu config --default-user root 会将 Ubuntu 发行版的默认用户更改为 “root” 用户。

如果上面命令无效，尝试下面的方法：

在 C:Users AppDataLocalMicrosoftWindowsApps 目录下启动终端（这里的 userName 是 Windows 的用户目录），执行下面的命令（这里以 Ubuntu-22.04 为例）：

代码语言：javascript复制

./ubuntu2204.exe config --default-user root

然后重启 WSL 服务。

关闭 WSL

代码语言：javascript复制

wsl --shutdown

高级配置

创建 C:Users<UserName>.wslconfig 文件：

代码语言：javascript复制

# Settings apply across all Linux distros running on WSL 2
# 设置适用于在WSL2上运行的所有Linux发行版
[wsl2]

# Limits VM memory to use no more than 4 GB, this can be set as whole numbers using GB or MB
# 将虚拟机内存限制为使用不超过28 GB的内存，可以使用GB或MB将其设置为整数
memory=28GB 

# Sets the VM to use 6 virtual processors
# 将虚拟机设置为使用6个虚拟处理器
processors=6

# Sets amount of swap storage space to 16GB, default is 25% of available RAM
# 将交换存储空间量设置为16 GB，默认值为可用RAM的25
swap=16GB

# Sets swapfile path location, default is %USERPROFILE%AppDataLocalTempswap.vhdx
# 设置交换文件路径位置，默认值为%USERPROFILE%AppDataLocalTempswap.vhdx
# swapfile=C:\temp\wsl-swap.vhdx

# Disable page reporting so WSL retains all allocated memory claimed from Windows and releases none back when free
# 禁用页面报告，以便WSL保留Windows要求的所有已分配内存，并且在空闲时不释放任何内存
pageReporting=false

# Turn off default connection to bind WSL 2 localhost to Windows localhost
# 关闭默认连接以将WSL 2 localhost绑定到Windows localhost
localhostforwarding=true

# Disables nested virtualization
# 禁用嵌套虚拟化
nestedVirtualization=false

# Turns on output console showing contents of dmesg when opening a WSL 2 distro for debugging
# 打开WSL 2发行版进行调试时，打开显示dmesg内容的输出控制台
debugConsole=true

配置代理

有两个关键步骤：

1. WSL2 中配置的代理要指向 Windows 的 IP；
2. Windows 上的代理客户端需要允许来自本地局域网的请求；

由于 Linux 子系统也是通过 Windows 访问网络，所以 Linux 子系统中的网关指向的是 Windows，DNS 服务器指向的也是 Windows，基于这两个特性，我们可以将 Windows 的 IP 读取出来。

例如，在 Ubuntu 子系统中，通过 cat /etc/resolv.conf 查看 DNS 服务器 IP。

代码语言：javascript复制

cat /etc/resolv.conf
# This file was automatically generated by WSL. To stop automatic generation of this file, add the following entry to /etc/wsl.conf:
# [network]
# generateResolvConf = false
nameserver 172.25.48.1

可以看到 DNS 服务器是 172.25.48.1，通过环境变量 ALL_PROXY 配置代理：

代码语言：javascript复制

export ALL_PROXY="http://172.25.48.1:7890"

7890 是 Windows 上运行的代理客户端的端口，记得要在 Windows 代理客户端上配置允许本地局域网请求。

一键配置脚本

将上面的过程写入一个 bash 脚本，可以轻松的实现一键配置代理：

代码语言：javascript复制

#!/bin/bash
host_ip=$(cat /etc/resolv.conf |grep "nameserver" |cut -f 2 -d " ")
export ALL_PROXY="http://$host_ip:7890"

脚本通过 cat /etc/resolv.conf 来获取 DNS 服务器，也就是 Windows 的 IP，再将其中的 IP 部分截取出来，加上代理客户端的端口（我的是 7890，可以根据自己实际情况修改），使用 export 写入环境变量中。

使用时只需要 source .proxyrc 就可以生效。

扩展配置

zsh 配置

安装 zsh

代码语言：javascript复制

sudo apt-get install zsh

切换默认终端为 zsh

代码语言：javascript复制

chsh -s /bin/zsh

安装 oh-my-zsh

oh-my-zsh 是一个流行的 zsh 配置框架，可以使用以下命令：

代码语言：javascript复制

# 安装 Oh My Zsh
wget https://github.com/robbyrussell/oh-my-zsh/raw/master/tools/install.sh -O - | sh

# gitee加速
wget https://gitee.com/mirrors/oh-my-zsh/raw/master/tools/install.sh -O - | sh

bash ./install.sh

上面方法安装不成功，可以尝试下面的方法：

先用 git 下载：

代码语言：javascript复制

git clone https://github.com/ohmyzsh/ohmyzsh.git ~/.oh-my-zsh

再替换zshrc

代码语言：javascript复制

cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc

~/.zshrc配置文件

代码语言：javascript复制

# 主要的几个配置选项
# Path to your oh-my-zsh installation.
export ZSH="/root/.oh-my-zsh"

# ZSH_THEME="robbyrussell"
# 设置字体模式以及配置命令行的主题，语句顺序不能颠倒
POWERLEVEL9K_MODE='nerdfont-complete'
ZSH_THEME="ys"
# ZSH_THEME="powerlevel9k/powerlevel9k"

# 以下内容去掉注释即可生效：
# 启动错误命令自动更正
ENABLE_CORRECTION="true"

# 在命令执行的过程中，使用小红点进行提示
COMPLETION_WAITING_DOTS="true"

# 要使用的插件
plugins=(
        git
        extract
        zsh-autosuggestions
        zsh-syntax-highlighting
)

source $ZSH/oh-my-zsh.sh
source $ZSH_CUSTOM/plugins/zsh-autosuggestions/zsh-autosuggestions.zsh

zsh 插件

zsh-autosuggestions

命令行命令键入时的历史命令建议插件，按照官方文档提示，直接执行如下命令安装：

代码语言：javascript复制

git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
# 更新
git clone https://gitee.com/han8gui/zsh-autosuggestions.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

zsh-syntax-highlighting

命令行语法高亮插件，按照官方文档提示，直接执行如下命令安装：

代码语言：javascript复制

git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
# 或者
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git 
echo "source ${(q-)PWD}/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh" >> ${ZDOTDIR:-$HOME}/.zshrc
# 更新
git clone https://gitee.com/Annihilater/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

安装字体

推荐使用 Powerlevel9k（用户量最大），如果要在 Oh My Zsh中安装，只需执行如下指令：

代码语言：javascript复制

git clone https://github.com/bhilburn/powerlevel9k.git ~/.oh-my-zsh/custom/themes/powerlevel9k

开发环境配置

安装/升级 Git 最新发行版本

默认是安装的 2.17.1 版本，不支持 git switch 命令。

查看当前的 Git 版本：

代码语言：javascript复制

git --version

添加 PPA 软件源：

代码语言：javascript复制

sudo add-apt-repository ppa:git-core/ppa

更新软件列表：

代码语言：javascript复制

sudo apt update

安装或更新 Git：

代码语言：javascript复制

sudo apt install git

再次查看 Git 版本，确认是否升级成功。

git pull 每次都需要输入密码

执行下面命令：

代码语言：javascript复制

git config --global credential.helper store

会在本地生成一个文本，记录账号和密码。再操作一次 git pull，会提示输入账号密码，这一次之后就不需要再次输入密码了。

git 命令报错

代码语言：javascript复制

error: unable to open loose object db310dcf85efc6052f4a98d4e2215b5ed9d42a6d: Input/output error
error: unable to open object pack directory: .git/objects/pack: Input/output error

Git 仓库位于一个挂载的文件系统中，而 Git 默认不会跨越文件系统边界来寻找 .git 目录，您可以设置环境变量 GIT_DISCOVERY_ACROSS_FILESYSTEM=1 来允许 Git 跨越文件系统边界。

在 WSL 中通过 VS Code 启动项目

WSL2 可以直接访问到 Windows 系统盘符中的文件，管不挂载到 /mnt 了。

比如我需要访问 D 盘中的 w3h5 项目：

代码语言：javascript复制

cd /mnt/d/code/w3h5

从 VS Code 启动：

代码语言：javascript复制

code .

如果第一次启动，会自动安装 VS Code 相关依赖。再次执行 code . 就可以直接拉起 VS Code ，并使用 Ubuntu 的开发环境了。

VS Code 连接 WSL

在 VS Code 插件中心搜索 WSL 安装即可。

安装 nvm

安装或更新 nvm，执行下面的 curl 或 wget 命令：

代码语言：javascript复制

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
# or
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash

安装 nrm

代码语言：javascript复制

pnpm i nrm -g

pnpm 报错

ERR_PNPM_NO_GLOBAL_BIN_DIR  Unable to find the global bin directory

使用 pnpm setup 命令，创建一个全局的 bin 目录，用来存放全局安装的包的可执行文件。

根据提示，进行配置：

代码语言：javascript复制

# 添加新行到 /root/.zshrc 
export PNPM_HOME="/root/.local/share/pnpm"
export PATH="$PNPM_HOME:$PATH"

# 然后请运行 
source /root/.zshrc

卸载WSL2子系统

1. 输入 wslconfig /l 查看当前系统下安装的wsl子系统版本
2. 输入 wslconfig /u <name> 注销需要删除的子系统 wslconfig /u Ubuntu-18.04
3. 可以再输入 wslconfig /l 检查一下，确认注销成功。

未经允许不得转载：w3h5-Web前端开发资源网 » Windows WSL2安装Ubuntu搭建开发环境教程，2023年5月更新

ubuntu windows 教程 开发环境 配置

0 人点赞