开发环境搭建-1：配置 WSL (类 centos 的 oracle linux 官方镜像)

一些 Linux 基本概念

发行版

WSL 的系统是基于特定发行版的特定版本的 Linux

发行版 = 有固定组织维护的、开箱就能用的 Linux

• 发行版由固定的团队、社区进行维护，出了问题有一定的支持
• 发行版的内容 = Linux内核 + 指定的一些实用软件组合（如软件包管理软件、可视化界面等）
• 不同发行版的授权协议有所不同，有的商用也是免费的，有的商用要付费

类比：比如不同厂商的音乐播放器，比如 QQ 音乐、网易云音乐、酷狗音乐等。本质都是音乐文件播放器，但在基础功能上定制了界面、曲库等功能

常见的软件发行版

• fedora系：fedora、centos、RHEL、open SUSE、oracle linux …
• debian系：debian、ubuntu

以上两大派系的常见差别

参考链接：https://fedoraproject.org/wiki/Comparison_to_other_distributions

• 系统指令：通用（都是基于 Linux 内核的），比如：cp、mv、rm、sudo、wget等。
• 一些与【实用软件组合】相关的指令，因为选用的软件不同，则支持的相关指令就不太相同，比如：

选择建议：建议以实际项目使用的发型版本，确定自己需要的版本，最好是使用相同发行商的。例如：

• 后端、运维：公司使用 cenots --> 自己使用 fedora 系的发行版，最好也用 centos
• 学术、机器学习：项目在 ubuntu 上部署 --> 使用 debian 系的发行版，最好也用 ubuntu

版本

发行版本

不同版本，系统内核版本、附带的软件版本可能不同

类比：比如 Windows 的不同版本，如 Winsdows XP、Windows 7、Windows 10，整体界面、操作、对软件的兼容性都有不同

• 不同系统内核版本，运行程序的效率可能有不同，也可能会有软件在不同内核上运行出问题的情况
• 附带软件不同，一般来说新版软件会修复 bug，并提供新的功能

对于 Linux 【发行版】来说，有大版本和小版本，以下以 CentOS 举例

• 大版本 = 版本数字整数部分，比如 centos 7.6 中的 6
• 小版本 = 版本数字小数部分，比如 Ubuntu 22.04 中的 04
• 这其中有一些版本，作为长期支持版本（进行介绍时会有 LTS 相关文字），官方会提供长久的支持

选择原则：建议大版本不变，小版本选最新的 LTS 版本。例如：

• 项目上说用的是 centos7（或者 centos 7.6），则自己可以用 centos 7.9
• 项目上说用的时 Ubuntu 24，那自己可以装 ubuntu 24.04 LTS

安装包版本

参考资料：https://blog.csdn.net/ZZQHELLO2018/article/details/104027963

以 CentOS 为例：

安装 WSL

注意：WSL 官方的安装方式要求能访问 github，最好是找个梯子，否则接下来的安装步骤非常难受

1. 打开 powershell （管理员）
   在 windows 图标右键，点击【终端（管理员）】
   
   之后的命令都在打开的命令行中输入

2. （非必须）查看指令帮助

   wsl --help
   

   

3. 查看支持的【发行版】

   wsl --list --online
   

   

4. 选择相关版本进行安装
   我项目使用的是 centos，应该选择 fedora 系的系统，这里选择 oracle linux
   项目上使用的版本是 centos 8,4，这里选择相同大版本的 oracle linux 8.7

   wsl --install OracleLinux_8_7
   

   

   输入logout即可退出 WSL，返回 Windows 命令行
   

   • 安装时会提示设置用户名、密码，之后登录 WSL 时，默认都会使用这个用户
   • 执行指令的过程中，如果提示“无法解析服务器名称或地址”，那就说明无法用官方指令进行安装，需要梯子
     相关问题参考：https://zhuanlan.zhihu.com/p/568008269

配置 WSL

将 WSL 移动到其他盘

   wsl --manage OracleLinux_8_7 --move D:/WSL_DIR/

打开对应文件夹，发现 WSL 的磁盘文件（.hdx 文件）已经在对应文件夹中了

mobXterm 配置远程连接到 WSL

• 如果下拉框没有对应选项，可以直接输入 WSL 的名称
  
• 汉化版 MobaXterm 在这里下载（github，需要梯子）：https://github.com/RipplePiam/MobaXterm-Chinese-Simplified

Linux 系统配置

进入 / 退出 Linux 系统

在 Linux 命令行中，输入logout退出 Linux 系统，返回 WSL 系统

设置 root 账户

参考：https://blog.csdn.net/weixin_44953227/article/details/109466253

输入sudo passwd root，进入设置，要输入两次密码

设置当前用户具有 root 权限

下面的流程能实现免密执行代码

1. 将当前用户加入 wheel 用户组（实际上 oracle linux 已经默认做了）
   可以看到，此时 sudo 指令还需要输入当前用户的密码

   sudo usermod -aG wheel $USER
   

2. 修改wheel用户权限，可以免密运行指令

   1. 打开权限管理配置文件
      这里打开文件使用的是vim软件，软件的具体使用方法请自行搜索，这里不再介绍

      sudo vim /etc/sudoers
      

   2. 修改以下内容，并强制保存退出

      

3. 重新执行程序，发现已经不需要输入密码了（只需要在指令前加sudo就行）
   

设置 Linux 软件源（repos）

默认的 WSL 系统软件源从官网获取，需要梯子，国内访问速度很慢
这里使用开源的项目：https://linuxmirrors.cn/

根据官网指南，先切换到 root 用户，然后运行脚本

sudo passwd root

切换到 root 用户，要输入 root 用户密码，若之前没设置过则先按照上一步设置 root 密码

根据 linuxmirrors-官网 给的教程，执行命令

然后执行脚本即可，这个脚本非常人性化，都是中文，不需要教程了
放点执行截图

执行结束，测试一下，安装个fastfetch软件（此软件可查看系统概况，软件官网（需要梯子））

发现报错PGP key not found

解决方法，下载 centos、EPEL 官方对应的 PGP 秘钥文件到对应路径，查看解决方法（原贴在 github 需要梯子）

Linux 系统优化

在 WSL 系统中进行配置，这里是在 Oracle Linux 8.7 中进行配置

关闭 SELinux

WSL 的 Oracle Linux 8.7 已经默认关闭，这里跳过
相关文档：https://help.aliyun.com/zh/ecs/use-cases/enable-or-disable-selinux

优化内核参数

按需配置，有相关报错再来配，没问题就不管
参考文章：https://developer.aliyun.com/article/700149

设置登录时显示系统概况

1. 安装fastfetch软件
2. 配置系统登录时显示的内容登录
   参考文章：https://cloud.tencent.com/developer/article/1869215

   1. 打开配置文件（要使用 root 权限）

      sudo vim /etc/profile
      

   2. 在最后添加以下内容，保存退出文件

      # hello screen
      sudo fastfetch
      

      3. 实际效果（每次登录都有以下内容显示）

3. 如果出现显示问题，请检查 MobaXterm 的连接参数
   把这里的连接参数裁成【原生连接器】，然后关闭窗口，重新打开
   

启用 systemd 支持（支持 systemctl 指令）

这对于很多运维人员来说很不方便，也可能导致一些依赖相关指令的脚本或程序运行失败

微软提供了相关文档：https://learn.microsoft.com/zh-cn/windows/wsl/systemd#how-to-enable-systemd

1. 检查版本（在 windows 命令行中执行命令）

   wsl --version
   

   可看到当前 wsl 版本满足要求
   

2. 修改配置文件（在 WSL 命令行中执行，这里使用vim作为文本编辑器，注意要 root 权限）

   sudo vim /etc/wsl.conf
   

   按照官方教程修改文件，并保存退出（如果没有对应的文件，就大胆的新建一个）
   

3. 重启 WSL（先关闭再启动）

   1. 关闭：在 windows 命令行中输入wsl --shutdown
   2. 启动（WSL 有活动，就会自动启动，这里直接远程连接，就能激活 WSL）

4. 重启之后，重新输入相关指令，正常运行
   

修改时间和时区

前提：首先设置启用 systemd，具体看上面的步骤

WSL 中的时间、时区会自动和主机 Windows 上的配置进行同步，无需设置

但如果想配置不同时区、手动设置时间，则可参考以下配置

参考文档：https://blog.csdn.net/wdk996/article/details/135940814

1. 查看当前时间相关配置：timedatectl指令
   

2. 设置时区：这里设为中国时区（Asia/Shanghai）

   timedatectl set-timezone "Asia/Shanghai"
   

3. 设置时间：使用date -s 时间字符串实现

此时系统级的服务（比如 dnf/yum 等）就能访问外网了，但是 git 还需要额外配置

其他特殊的WSL配置

修改 WSL 的文件位置

wsl --manage WSL名称 --move 新路径

以下将OracleLinux_8_7这个WSL的系统文件移动到D:/WSL_DIR/路径下（D盘下的WSL_DIR文件夹下）

挂载 windows 的文件夹到 WSL 中

卸载某一版本的 WSL

1. 查询当前已经安装的 WSL

    wsl --list -v
   

   

2. 停止对应的 WSL

   wsl --shutdown WSL名称
   

   

3. 解除挂载的磁盘
   不解挂直接删除也行，WIndows 系统会自动解除挂载的

   wsl --umount 磁盘盘符
   

4. 卸载对应的 WSL

   wsl --unregister WSL名称
   

   

开发运行环境配置

git 安装及代理加速

git 软件设置代理（全局设置）

git config --global http.proxy $http_proxy
git config --global https.proxy $https_proxy

如果要禁用代理

先临时禁用系统代理

unset $http_proxy
unset $https_proxy

永久禁用

1. 进入上面的环境文件~/.bashrc，删除（或注释掉）上面添加的三行，保存退出
2. 使用source ~/.bashrc应用配置文件
3. 使用上面的unset指令删除当前残留的环境变量

再禁用 git 代理

git config --global --unset http.proxy
git config --global --unset https.proxy

注意：上面的操作需要先禁用 git 代理，再禁用系统代理

配置 Python 开发环境（uv）

使用uv进行 python 版本、项目、依赖包、虚拟环境管理
详见文章：配置 python 运行环境（使用 uv 管理 python 项目）

配置 node 前端开发环境（nvm+node+pnpm）

详见文章：配置 nodejs 开发环境 (nvm + pnpm)