WSL Distribution Switcher 使用手册

---

1. 项目目录结构及介绍

WSL Distribution Switcher 是一个旨在便捷地在Windows Subsystem for Linux（WSL）中切换不同Linux发行版的工具。以下是该仓库的基本目录结构概述：

• 根目录:

  • switch.py: 核心脚本，负责处理Linux发行版之间的切换逻辑。
  • install.py: 可能用于安装新分布或进行初始设置的脚本。
  • README.md: 包含项目说明、使用步骤和一些注意事项的文档。
  • requirements.txt: 列出了项目运行所需的Python库列表，以便环境配置。

• scripts: 如果存在，可能包含辅助脚本或者特定于某些操作的子脚本。

• docs: 可能存放更详细的官方文档或教程，尽管实际仓库中可能未直接提供此目录。

该项目的核心在于其脚本，尤其是switch.py，它允许用户通过简单的命令来替换WSL背后的操作系统发行版。

---

2. 项目启动文件介绍

主要脚本：switch.py

• 功能: 此脚本是项目的主要执行程序，用于在不同的Linux发行版之间进行切换。它通过重命名WSL中的根文件系统(rootfs)目录来实现这一目标，确保每次仅有一个分布版本处于启用状态。

• 使用方法: 用户需要从Windows环境运行此脚本，并指定想要切换到的Linux发行版的Docker镜像名称和标签，例如：

  python switch.py fedora:rawhide
  

• 重要性: 它简化了原本复杂的更换WSL内核发行版过程，无需重新配置整个环境。

---

3. 项目的配置文件介绍

WSL Distribution Switcher本身依赖外部输入参数而非传统的配置文件。然而，发行版切换的关键信息是通过脚本执行时提供的镜像名和标签动态确定的。这意味着用户的"配置"实际上是通过运行switch.py时提供的命令行参数来定义的。

• 自定义: 虽然没有直接的配置文件来定制行为，但用户可以通过修改脚本中的默认参数或在执行脚本前设置环境变量来间接实现一定程度的自定义。

• 注意事项: 在进行任何更改之前，理解脚本内部逻辑非常重要，以避免不必要的错误或数据丢失。

---

这个指南介绍了如何理解和使用WSL Distribution Switcher项目的基础，强调了核心脚本的作用以及用户交互方式，而未涉及具体配置文件，因为该工具采取的是命令行参数驱动的方式。