Python 环境一键安装神器

一个功能强大且极致易用的 Python 环境可视化安装工具。它旨在解决 Python 环境配置複杂、依赖安装速度慢、多版本管理困难等常见痛点。无论您是 Python 新手还是经验丰富的开发者，都能为您提供丝滑、高效的安装体验。

本工具深度集成了 Xget 全球加速服务，确保您在下载和安装过程中的每一个环节都能享受到极致的速度。

✨ 核心功能

• 🚀 全球加速：深度集成 Xget，为系统包、Git 仓库、Pip 包等提供全球 CDN 加速，告别龟速下载。
• 💡 双模式安装：提供两种主流的安装方案，满足不同需求：
  • UV：快如闪电的次世代 Python 打包工具，轻量且高效，推荐首选。
  • Pyenv + Poetry：经典组合，提供强大的 Python 多版本管理和精细的依赖控制。
• 🤖 智能自动化：自动检测操作系统，并为 Debian/Ubuntu 系统自动安装所需依赖，真正实现一键式操作。
• 🤫 静默安装：安装过程中的详细日志会自动保存到 /tmp/python_installer.log，保持终端介面清爽，只展示核心信息和进度。
• 🌐 多语言支持：提供中文和英文双语介面，满足不同用户的需求。

🚀 快速开始

1. 下载脚本

通过 curl 或 wget 下载最新版本的安装脚本：

# 使用 curl
curl -L -o installer.sh "https://github.com/Adoubf/py_installer/releases/download/product/installer_v1.0.sh"
# 或者使用 wget
wget -O installer.sh "https://github.com/Adoubf/py_installer/releases/download/product/installer_v1.0.sh"

2. 授予执行权限

chmod +x installer.sh

3. 运行脚本

推荐使用 sudo 运行，因为脚本需要权限来安装系统级的编译依赖，并修改 APT 源列表。

sudo ./installer.sh

---

🛠️ 安装方法详解

1. UV (推荐)

UV 是一个用 Rust 编写的极速 Python 包解析器、安装器、锁定器和虚拟环境管理器。它被设计为 pip 和 venv 的直接替代品，性能卓越。

• 优点：安装速度极快，磁盘佔用小，是现代 Python 项目的理想选择。
• 适合：需要快速搭建和迭代项目的开发者，特别是数据科学、Web 开发等领域。

2. Pyenv + Poetry

这是一个功能强大且被广泛验证的经典组合。

• Pyenv：用于轻鬆管理和切换多个 Python 版本（例如，同时安装 Python 3.8 和 3.11）。
• Poetry：提供强大的项目依赖管理和打包功能，确保环境的一致性和可複现性。
• 优点：对多版本有强需求，需要精细化管理项目环境。
• 适合：需要同时维护多个项目，或项目对特定 Python 版本有严格要求的开发者。

---

📖 使用说明

脚本启动后，您将进入一个可视化的菜单驱动流程：

1. 语言选择：首先选择您习惯的语言（默认中文）。
2. 方法选择：根据您的需求选择 UV 或 Pyenv + Poetry。
3. 版本选择：从列表中选择一个常见的 Python 版本，或手动输入您需要的特定版本号。
4. 安装摘要：脚本会显示您的所有选择，请检查并确认。
5. 自动安装：确认后，脚本将开始全自动安装，您只需稍作等待，进度条会告诉您当前进度。
6. 完成：安装成功后，会提示您需要重新打开终端或执行 source ~/.bashrc 来使环境生效。

❓ 故障排除

如果在安装过程中遇到问题，请不要担心。

• 查看日志：所有详细的安装输出（包括错误信息）都记录在日志文件中：/tmp/python_installer.log。当安装失败时，请首先查看此文件。

  cat /tmp/python_installer.log

• 网络问题：尽管脚本使用了 Xget 加速，但如果您的网络完全中断，git clone 或 curl 等命令仍可能失败。请检查您的网络连接。
• 编译失败：如果在使用 Pyenv 安装时遇到编译错误，通常是因为缺少了特定的编译依赖。脚本会自动安装大部分常见依赖，但对于一些非常规的系统，您可能需要根据日志中的错误提示手动安装。

🤝 贡献

欢迎任何形式的贡献！如果您有好的想法或发现了 Bug，请随时提出 Issue 或 Pull Request。

📝 许可证

本项目採用 MIT 许可证