EnderRealm 技术文档

外观

Python 环境 ​

Python 是 EnderRealm 后端服务使用的编程语言。你需要安装 Python 3.12 或更高版本。

什么是 Python？ ​

Python 是一种高级编程语言，由 Guido van Rossum 在 1991 年创建。它的特点包括：

  • 简洁易读：语法接近自然语言，易于学习
  • 跨平台：支持 Windows、macOS、Linux
  • 丰富的库：拥有庞大的标准库和第三方库
  • 多范式：支持面向对象、函数式、过程式编程

为什么需要 Python？ ​

EnderRealm 项目使用 Python 构建后端服务（EnderRealmServerApi），主要功能包括：

  • i18n 国际化：管理多语言文本
  • 环境配置：管理服务器环境变量
  • API 服务：提供 RESTful API 接口
  • 数据库操作：与 PostgreSQL 交互

安装 Python 3.12+ ​

Windows ​

方法一：官方安装包（推荐） ​

  1. 访问 Python 官网
  2. 下载 Python 3.12 或更高版本
  3. 运行安装包
  4. 重要：勾选"Add Python to PATH"
  5. 点击"Install Now"

方法二：使用包管理器 ​

powershell
# 使用 winget
winget install Python.Python.3.12

# 使用 scoop
scoop install python

# 使用 chocolatey
choco install python --version=3.12.0

macOS ​

方法一：使用 Homebrew（推荐） ​

bash
# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Python
brew install python@3.12

方法二：官方安装包 ​

  1. 访问 Python 官网
  2. 下载 macOS 安装包
  3. 运行安装包，按提示完成安装

Linux ​

Ubuntu/Debian ​

bash
# 更新包列表
sudo apt update

# 安装 Python 3.12
sudo apt install python3.12 python3.12-venv python3-pip

# 设置为默认版本（可选）
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.12 1

CentOS/RHEL/Fedora ​

bash
# CentOS/RHEL
sudo yum install python3.12

# Fedora
sudo dnf install python3.12

验证安装 ​

打开终端，运行以下命令：

bash
# 验证 Python 版本
python --version
# 或
python3 --version

# 验证 pip 版本
pip --version
# 或
pip3 --version

应该看到类似输出：

Python 3.12.x
pip 23.x.x from ... (python 3.12)

什么是 pip？ ​

pip 是 Python 的包管理工具，用于安装和管理 Python 包。它类似于：

  • Windows: npm（Node.js）、NuGet（.NET）
  • macOS/Linux: apt（Ubuntu）、brew（macOS）

配置 pip ​

更换镜像源（推荐） ​

国内用户建议更换为国内镜像源，提高下载速度：

bash
# 临时使用
pip install <package> -i https://pypi.tuna.tsinghua.edu.cn/simple

# 永久配置
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

常用镜像源：

什么是虚拟环境？ ​

虚拟环境是 Python 的隔离环境，用于：

  • 隔离依赖：不同项目使用不同版本的包
  • 避免冲突：防止全局安装的包相互干扰
  • 便于管理：每个项目有独立的依赖列表

创建虚拟环境 ​

bash
# 创建虚拟环境
python -m venv .venv

# 激活虚拟环境
# Windows
.venv\Scripts\activate

# macOS/Linux
source .venv/bin/activate

# 退出虚拟环境
deactivate

什么是 uv？ ​

uv 是一个现代 Python 包管理工具，由 Astral 开发。它的特点包括：

  • 极快：比 pip 快 10-100 倍
  • 兼容：兼容 pip 和 requirements.txt
  • 现代：支持 pyproject.toml
  • 可靠：使用 Rust 编写，性能优秀

安装 uv ​

bash
# 使用 pip 安装
pip install uv

# 使用官方安装脚本
curl -LsSf https://astral.sh/uv/install.sh | sh

# 使用 Homebrew（macOS）
brew install uv

常见问题 ​

Q: python 和 python3 有什么区别？ ​

A: 在某些系统上：

  • python 可能指向 Python 2
  • python3 指向 Python 3

建议使用 python3 和 pip3 确保使用 Python 3。

Q: 如何管理多个 Python 版本？ ​

A: 可以使用以下工具：

  • pyenv（macOS/Linux）
  • pyenv-win（Windows）
  • conda（跨平台）

Q: pip install 权限错误怎么办？ ​

A: 不要使用 sudo pip install，而是：

  1. 使用虚拟环境（推荐）
  2. 使用 pip install --user

推荐学习资源 ​

下一步 ​

Python 环境安装完成后，让我们继续学习 PostgreSQL 数据库。

© 2022-present EnderRealm. All rights reserved.