环境搭建

约 573 字大约 2 分钟

2026-08-15

提示

本页面为开发者文档，主要面向 EuoraCraft Launcher 的开发者和贡献者。如果您是普通用户，那么请您关闭此页面或者返回主页，此页面不影响您使用 EuoraCraft Launcher 的功能。

开始

开始开发 EuoraCraft Launcher 之前，您需要先搭建开发环境。以下是详细的步骤和要求。

在正式开始前，请确保您已经安装了以下工具和软件：

首先，您需要克隆 EuoraCraft Launcher 的源码仓库。因为该项目使用了 Git 子模块，所以请使用以下命令克隆所有仓库：

git clone --recurse-submodules https://github.com/ECLteam/EuoraCraft-Launcher.git

如果您直接克隆了主仓库ECLteam/EuoraCraft-Launcher，请使用以下命令初始化子模块：

git submodule sync --recursive
git submodule update --init --recursive

如果没有报错，那么恭喜您可以进入下一步了。

注

鉴于国内网络环境的限制，建议您使用国内镜像源来安装依赖，以提高下载速度和成功率。以下是一些常用的国内镜像源：

Python 镜像源：
- 清华大学：https://pypi.tuna.tsinghua.edu.cn/simple
- 阿里云：https://mirrors.aliyun.com/pypi/simple/
Node.js 镜像源：
- 淘宝镜像：https://registry.npmmirror.com/

因为 EuoraCraft Launcher 采用前后端分离的架构，所以我们需要分别安装前端和后端的依赖。执行以下命令安装后端依赖：如果您使用的是 Windows PowerShell，请执行：

# Windows PowerShell
python -m venv .venv # 创建虚拟环境
.\.venv\Scripts\Activate.ps1 # 激活虚拟环境
python -m pip install -e ".[dev]" # 安装依赖

如果您使用的是 Linux 或 macOS，请执行：

python -m venv .venv # 创建虚拟环境
source .venv/bin/activate # 激活虚拟环境
python -m pip install -e ".[dev]" # 安装依赖

安装完后端依赖后，您可以进入前端目录，安装前端依赖：

cd frontend
pnpm install # 您也可以使用 npm 或 yarn 安装依赖，但我们推荐使用 pnpm

好了，如果不出意外，您已经完成了开发环境的搭建，接下来您可以开始开发 EuoraCraft Launcher 了。

2026/8/14 17:34

查看所有更新日志