Win11+WSL2+Ubuntu+Rust+VSCode环境配置

LarryLan

发布于 2026-01-16 11:08:32

1730

一、安装WSL

参考：安装 WSL | Microsoft Learn

1.先决条件

必须运行 Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）或 Windows 11 才能使用以下命令

2.安装命令

以管理员身份运行PowerShell，并输入以下命令：

wsl --install

此命令将启用运行WSL并安装Linux的Ubuntu分发版所需的功能

2.1更改安装默认的Linux分发版(LTS)

2.1.1通过以下命令查看在线商店可用的Linux分发版列表

wsl --list --online
或者 wsl -l -o

正常情况会出现：

可能会出现以下情况：

无法从“https://raw.githubusercontent.com/microsoft/WSL/master/distributions/DistributionInfo.json”提取列表分发。无法解析服务器的名称或地址
错误代码:Wsl/WININET_E_NAME_NOT_RESOLVED

在网络查到一般有两种解决方式

1.修改DNS。参考链接：解决windows 安装wsl的部分问题_distributioninfo.json-CSDN博客

2.将域名与IP地址在hosts文件中进行映射。参考链接：解决raw.githubusercontent.com无法访问的问题-CSDN博客

这两种方式，我都测过没有用。最直接的办法就是打开梯子，VPN会通过加密隧道绕过本地网络策略，直接访问微软的全球CDN节点。

2.1.2 更改安装的分发版，选择上面展示的分发版的名称

wsl --install Debian

3.检查正在运行的WSL的版本

3.1 列出所有的Linux分发版和WSL的版本

wsl --list --verbose
或 wsl -l -v

......更多wsl命令，查看微软官方教程：设置 WSL 开发环境 | Microsoft Learn

二、安装Rust

1.启动Ubuntu

1.1 通过在powerShell命令行中启动

wsl

1.2 打开Ubuntu终端启动

2.为Ubuntu换源

2.1Ubuntu版本号大于等于24.04，使用以下命令

sudo cp /etc/apt/sources.list.d/ubuntu.sources /etc/apt/sources.list.d/ubuntu.sources.bak
sudo sed -i "s|http://.*archive.ubuntu.com|https://mirrors.tuna.tsinghua.edu.cn|g" /etc/apt/sources.list.d/ubuntu.sources
sudo sed -i "s|http://.*security.ubuntu.com|https://mirrors.tuna.tsinghua.edu.cn|g" /etc/apt/sources.list.d/ubuntu.sources

2.2 Ubuntu版本号小于24.04，使用以下命令

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak 
sudo sed -i "s|http://.*archive.ubuntu.com|https://mirrors.tuna.tsinghua.edu.cn|g" /etc/apt/sources.list 
sudo sed -i "s|http://.*security.ubuntu.com|https://mirrors.tuna.tsinghua.edu.cn|g" /etc/apt/sources.list

3.安装Rust编译器套件

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

3.1 验证安装是否成功

cargo -V
或cargo --version
# 显示cargo 版本号就证明安装成功

4.安装GCC

Rust编译期需要C环境支持，使用以下命令安装GCC:

sudo apt update
sudo apt install gcc

5.安装rust-src

我安装完成，运行测试时，提示我无法打开rust-src库。是因为没有安装，所以手动安装一下

rustup component add rust-src

验证安装

rustup component list | grep rust-src

三、配置VSCode

1.安装插件WSL

WSL插件，用于远程链接WSL2

2.VScode与WSL的连接

2.1 方法一

在VSCode上方的搜索框中输入">"，打开命令面板，再输入WSL，选择wsl:连接到wsl。选择Ubuntu中的项目文件夹即可。

2.2 方法二

在Ubtuntu的终端中，进入到项目文件夹，输入code .并回车，就可直接打开VScode。

3.安装插件

在VSCode插件市场中搜索rust-analyze并安装。用于提供代码补全、语法高亮等功能

四、验证环境

创建一个新项目

cargo new --bin helloworld

显示

Created binary(application) 'helloworld' package

运行

cargo run

显示

大功告成！！！可以开始随意的玩弄Rust了

本文参与腾讯云自媒体同步曝光计划，分享自微信公众号。

原始发表：2025-10-13，如有侵权请联系 cloudcommunity@tencent.com 删除

插件

本文分享自 Larry的Hub 微信公众号，前往查看

如有侵权，请联系 cloudcommunity@tencent.com 删除。

本文参与腾讯云自媒体同步曝光计划，欢迎热爱写作的你一起参与！

登录后参与评论

0 条评论

热度