Python版本切换器完整文档
🐍 Python版本切换器：轻松管理你的Python环境 🚀
在开发Python项目时，频繁切换不同版本的Python是常有的事。但每次手动修改环境变量，是不是让你感到头大？别担心！今天，我给大家带来了一个超级实用的工具——Python版本切换器🎉。它不仅能自动检测系统中已安装的Python版本，还能快速切换环境变量，简直是Python开发者的福音！
🌟 功能特点
🚀 自动检测系统中已安装的所有Python版本
无需手动输入，程序启动后会自动扫描系统中已安装的Python版本，方便快捷！
💻 支持修改系统环境变量
需要管理员权限，但一旦设置好，切换Python版本就像点击一个按钮那样简单。
📁 支持手动添加Python安装目录
如果自动检测没有找到你想要的Python版本，你可以手动添加其安装目录。
🔄 实时显示当前系统Python版本
清晰地告诉你当前正在使用的Python版本，避免混淆。
👀 清晰的界面展示所有Python版本状态
一目了然地看到所有已安装的Python版本及其状态。
📋 支持路径的导入导出
方便你备份和迁移你的Python路径设置。
🔒 安全的环境变量修改机制
确保在修改系统环境变量时不会出现意外。
🖥️ 系统要求
操作系统
仅支持Windows系统。
权限
需要管理员权限来修改系统环境变量。
Python版本
系统中需安装Python 3.6或更高版本。
📥 安装说明
方法1：下载可执行文件
- 访问项目主页：https://github.com/SV990/Python-Switch
- 在Releases页面下载最新版本的
Python版本切换器.exe文件 - 将下载的文件保存到本地，双击运行即可
方法2：从源代码运行
bash
git clone https://github.com/SV990/Python-Switch.git
cd Python-Switch
pip install -r requirements.txt
python switch.py
🎯 使用方法
启动程序
- 双击
Python版本切换器.exe：这是最简单的方式 - 右键选择"以管理员身份运行"：如果你需要修改系统环境变量，这是推荐的方式
- 程序会自动请求管理员权限：如果你没有以管理员身份运行，程序会自动请求管理员权限
查看Python版本
- 程序启动后会自动扫描系统中已安装的Python版本：无需手动操作
- 左侧列表显示所有检测到的版本：你可以清晰地看到所有已安装的Python版本
- 状态列显示是否在系统环境变量中：这可以帮助你了解当前的环境变量设置
添加Python路径
- 点击"添加Python路径"按钮：这是添加自定义Python路径的入口
- 选择Python安装目录（包含python.exe的目录）：确保你选择的是正确的目录
- 程序会自动验证并添加：避免手动输入错误
切换Python版本
- 在列表中选择目标版本：找到你想要切换到的Python版本
- 点击"切换选中版本"按钮：程序会自动修改系统环境变量
- 等待操作完成提示：耐心等待，程序会告诉你操作是否成功
- 重新打开命令行窗口以使更改生效：这是必须的，因为环境变量的更改需要重新加载
删除自定义路径
- 选择要删除的路径：在列表中找到你想要删除的路径
- 点击"删除选中路径"按钮：程序会自动删除该路径
- 仅支持删除手动添加的路径：自动检测的路径不能被删除
📁 配置文件
- 配置文件保存在用户主目录下：
~/.python_switcher_config.json - 包含自定义添加的Python路径：方便你备份和迁移
- 程序启动时自动加载：无需手动操作
- 修改路径时自动保存：确保你的设置不会丢失
🔨 故障排除
需要管理员权限
- 确保以管理员身份运行程序：这是修改系统环境变量的必要条件
- 如果看到权限错误提示，请重新以管理员身份运行：不要忽视权限问题
Python版本未显示
- 检查Python是否正确安装：确保Python已正确安装在你的系统中
- 确认安装目录包含python.exe：这是Python的可执行文件
- 使用"刷新版本列表"按钮更新：有时候需要手动刷新
环境变量未生效
- 切换版本后需要重新打开命令行窗口：这是环境变量生效的必要步骤
- 检查系统环境变量是否正确更新：确保环境变量已正确修改
- 确认是否有其他程序锁定了环境变量：避免冲突
路径保存失败
- 检查用户目录是否有写入权限：确保程序有权限写入配置文件
- 确认配置文件未被锁定：避免文件被其他程序占用
🛠️ 技术说明
- 开发语言：使用Python标准库开发，确保与Python的兼容性
- 图形界面：使用tkinter构建，提供简单易用的图形界面
- 环境变量管理：通过Windows注册表管理环境变量，确保修改生效
- 兼容性：支持32位和64位Python，兼容多种Python环境
- 自动处理：自动处理路径冲突和重复，避免手动干预
⚠️ 注意事项
环境变量修改
- 修改系统环境变量需要管理员权限：这是必须的
- 修改后需要重新打开命令行窗口：确保环境变量生效
- 请勿在运行其他安装程序时修改：避免冲突
Python路径
- 确保添加的是正确的Python安装目录：这是关键
- 路径中应包含python.exe：这是Python的可执行文件
- 建议使用官方安装包安装的Python：确保兼容性和稳定性
安全性
- 不要在不信任的环境中运行：保护你的系统安全
- 保护好管理员权限：不要随意泄露
- 定期备份环境变量配置：避免意外丢失
📜 版本历史
v1.0.0 (2025-05-13)
- 初始发布：这是第一个版本
- 支持系统环境变量修改：这是核心功能之一
- 自动检测Python版本：方便用户快速上手
- 基础界面功能：提供了一个简单的图形界面
📝 许可证
本项目采用MIT许可证，你可以自由使用和修改这个工具。
🤝 贡献指南
欢迎提交问题和改进建议！
- Fork本仓库：这是第一步
- 创建您的特性分支：开始你的开发
- 提交您的改动：这是你的贡献
- 推送到分支：让其他人可以看到你的改动
- 创建一个新的Pull Request：等待合并
📬 联系方式
如有问题或建议，请通过以下方式联系：