【dev on wsl2】wsl2 with vscode简单配置
wsl2 with vscode简单配置
正文开始@Assassin
目录：
- wsl2 with vscode简单配置
-
- 1. 安装wsl2：
-
- 1.1 安装方式选择：
- 1.2 命令行安装：
- 2. 搭配vscode：
-
- 2.1 新建用户&&远程连接vscode
- 2.2 配置C++开发环境：
1. 安装wsl2：
1.1 安装方式选择：
安装wsl2一般来说有三种方式：
- cmd/powershell 命令行安装（建议管理员模式）
- microsoft store 安装
- microsoft 官网安装
ps： win + R调出运行框，输入"winver" 查看 Windows 版本及内部版本号
① 命令行安装wsl的先决条件是必须运行 Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）或 Windows 11。 命令行安装默认会装在C盘。
② Microsoft Store最恶心的就是可能会打不开，我的就打不开-_-|，目前还没找到合适的解决方法。微软商店安装默认会安装到C盘。
③ Microsoft官网下载，目前来说，这是唯一不会出差错的方法，不过下载速度太慢了，我挂了代理也还是很慢，速度不到500KB/s。可以自行选择安装的路径。
由于我的电脑版本满足命令行安装的最低要求，故采用命令行的方式进行安装：
1.2 命令行安装：
环境准备：
以管理员权限启动powershell/cmd，然后输入以下命令启用虚拟机平台：
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform
以管理员权限启动powershell/cmd，然后输入以下命令启用linux子系统功能：
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
wsl --install默认会安装wsl1，使用以下命令设置wsl2为默认下载版本：
wsl --set-default-version 2
ps：以下命令也是同样的功能：
# 启用 WSL
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
# 启用 VMP
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
# wsl --install默认会安装wsl1，使用以下命令设置wsl2为默认下载版本
wsl --set-default-version 2
若出现报错，下载wsl2内核更新包并安装。
更为直观便捷的方法是直接在"windows功能"中启用标记的功能，也是同样的效果：
三种方式任选其一即可。
用管理员模式打开 cmd/powershell，使用命令行进行wsl2的安装：
wsl --install
执行上述命令会默认下载ubuntu，若想指定版本安装，可以执行如下命令：
wsl --install -d <DistroName>
查看当前linux可用发行版列表：
wsl --list --online
以下载Debian作为演示：
这中间有个小插曲，好像并没有下载成功，wsl -l -v列出来的信息没有debian，使用wsl也会报错，提示未在BIOS中启用虚拟化：
google了一番之后，可以初步确定是我本机上使用了VMware虚拟机的缘故，之前使用docker的时候也是因为Hyper-v不能打开虚拟机，因为Vmware自带虚拟化内核，二者会产生一定的冲突，于是我就把Hyper-v关闭了。
解决方法如下：
开启Hyper-v : 在cmd/powershell中执行以下命令行（建议管理员模式）：
bcdedit /set hypervisorlaunchtype auto
切换之后reboot重启电脑应该就ok了
ps：
关闭Hyper-v : 在cmd/powershell中执行以下命令行（建议管理员模式）：
bcdedit /set hypervisorlaunchtype off
若要使用虚拟机需要关闭Hyper-v。
开启了Hyper-v之后就能正常启动Debian了，完事儿
正常使用Debian操作系统：
更改wsl版本：
要是安装了wsl1，可以通过wsl --set-version更换发行版的版本：
wsl --set-version <distribution name> <versionNumber>
distribution name为发行版的名称，versionNumber为版本。
比如如果下载了Ubuntu-20.04 wsl1，可以执行以下命令更改到wsl2：
wsl --set-version Ubuntu-20.04 2
设置默认linux发行版：
我主机上默认的linux发行版是带 * 的Ubuntu-20.04：
将默认linux发行版改为刚刚下载的Debian：
wsl --set-default Debian
#可简写为 wsl -s 
2. 搭配vscode：
2.1 新建用户&&远程连接vscode
下面使用自己熟悉的ubuntu来进行演示。
一般来说，操作linux平台都不直接使用root用户，所以这里演示添加普通用户的操作。
添加普通用户：
wsl2中添加普通用户的操作与真正的linux环境还是有些不一样的，自己遇到了一些坑，比如我要新建一个名为xiaoming的普通用户：
root@KevinGeorge:~# useradd xiaoming
root@KevinGeorge:~# passwd xiaoming
新建了xiaoming用户，并为其设置了密码，但是登录不成功，提示no such file or directory：
ls -l查看 /home路径，发现家目录中并没有xiaoming用户：
于是使用man手册查看了一下useradd的选项，发现需要加上-m选项才能创建家目录，有点离谱：
彻底删除之前创建的xiaoming用户：
root@KevinGeorge:~# userdel -r xiaoming
带上-m选项创建xiaoming用户：
切换到xiaoming用户后发现没有用户的彩色控制台提示符（Color Prompt），原因应该是使用的shell是/bin/sh，而我们一般使用的shell是/bin/bash：
还是得推倒重来，彻底删除xiaoming用户，重新带上-s /bin/bash指定一下bash：
root@KevinGeorge:~# useradd -m xiaoming -s /bin/bash
root@KevinGeorge:~# passwd xiaoming
再次切换就有了彩色提示符：
自此，可以使用vscode远程连接wsl2的普通用户了。
打开vscode，安装对应的remote远程连接插件：
在terminal中输入code .打开vscode：
远程连接到我的ubuntu20-04：
如果输入code .出现如下报错：原因是曾经用root用户使用过 code .命令，所以普通用户再次使用就会报 Permission denied
参考自xx大佬
可以执行命令删除该文件：
xiaoming@KevinGeorge:~$ sudo rm -f /tmp/remote-wsl-loc.txt
使用多用户进行操作时，还可能出现如下错误：提示 code not found
测试了一下，code应该只能由wsl的默认登录用户使用，现在的默认登录用户是xiaoming，所以NingHai用户无法正常使用，使用如下指令可以修改wsl的默认登录用户：
ubuntu2004 config --default-user NingHai
默认登录用户切换到NingHai，启动ubuntu自动登录NingHai用户，此时可以正常使用code .：
2.2 配置C++开发环境：
在ubuntu上安装C/C++开发环境包：
下载安装包含大部分开发所需组件的 build-essential 组件包：
首先更新一下软件库：
xiaoming@KevinGeorge:~/cpp_code$ sudo apt update
安装C/C++编译调试工具集合：
sudo apt install build-essential
验证gcc/g++/gdb/make是否安装成功：
一些便于C++开发的插件也可以自行下载一下，基本上到这里就能够有一个很好的linux c++编辑+编译环境了：
至于vscode中使用ctrl+f5进行的编译和调试之类的操作，个人觉得没有必要去配置（.vscode文件夹中的tasks.json，launch.json，settings.json，c_cpp_properties.json），直接熟练使用linux中的命令行编译就很ok了，也比较贴合实际的linux开发环境。实在想有一个很好的调试环境建议visual studio，gdb也是很好的（如果会用的话）。
over~