FlyEnv 全栈开发环境管理工具使用指南

FlyEnv 是一个全栈开发环境管理工具，帮助开发者快速搭建本地开发环境。它通过快速多版本切换、全栈技术支持和无缝跨平台体验简化开发流程。无论您使用 PHP、NodeJS、Java、Go、Rust 还是 Python，FlyEnv 都能通过单一命令集成所有必要工具，让您专注于创作而非调试。

项目结构概览

FlyEnv 采用模块化架构设计，主要包含以下核心目录：

├── configs/                    # 配置文件目录
│   ├── electron-builder.ts     # Electron 构建配置
│   ├── esbuild.config.ts       # ESBuild 打包配置
│   └── vite.config.ts          # Vite 开发服务器配置
├── scripts/                    # 构建脚本目录
│   ├── app-builder.ts          # 应用构建脚本
│   └── dev-runner.ts           # 开发运行脚本
├── src/                        # 源代码目录
│   ├── main/                   # 主进程代码
│   │   ├── Application.ts      # 应用主类
│   │   ├── Launcher.ts         # 应用启动器
│   │   └── core/               # 核心模块
│   ├── fork/                   # 异步进程代码
│   │   ├── module/             # 服务模块
│   │   └── util/               # 工具类
│   ├── render/                 # 渲染进程(Vue 前端)
│   └── helper/                 # 辅助模块
├── static/                     # 静态资源目录
│   ├── sh/                     # Shell 脚本
│   ├── tmpl/                   # 配置文件模板
│   └── zip/                    # 压缩资源文件
└── package.json                # 项目依赖配置

核心特性

多版本环境管理

FlyEnv 支持 PHP、NodeJS、Java 等多个运行时的多版本并行管理，支持项目级环境隔离，进入项目目录时自动切换环境版本。

全栈服务集成

• Web 服务器: Apache、Nginx、Caddy、Tomcat
• 数据库: MySQL、MariaDB、PostgreSQL、MongoDB
• 缓存与队列: Redis、Memcached、RabbitMQ
• 编程语言: PHP、Java、Python、Go、Rust、Ruby
• 搜索引擎: Elasticsearch、Meilisearch、Typesense
• 工具服务: DNS 服务器、FTP 服务器、邮件服务器

跨平台支持

FlyEnv 原生支持 macOS、Windows 和 Linux 系统，提供一致的开发体验。

安装方法

macOS 系统

通过 Homebrew 安装：

brew install flyenv

或下载安装包：

• Intel 芯片: FlyEnv-4.10.8.dmg
• Apple 芯片: FlyEnv-4.10.8-arm64.dmg

Windows 系统

• 安装版: FlyEnv-Setup-4.10.8.exe
• 便携版: FlyEnv-Portable-4.10.8.exe

Linux 系统

• Debian/Ubuntu: FlyEnv-4.10.8-x64.deb
• RedHat/Fedora: FlyEnv-4.10.8-x64.rpm

开发环境搭建

克隆项目

git clone https://gitcode.com/gh_mirrors/ph/PhpWebStudy
cd PhpWebStudy

安装依赖

yarn install

开发模式运行

yarn run dev

构建项目

yarn run build

应用界面概览

FlyEnv 提供直观的图形界面，支持服务管理、配置编辑、日志查看等功能。

配置文件说明

FlyEnv 采用分层配置架构：

主配置文件

位于 configs/ 目录，包含构建配置和开发服务器配置。

服务配置模板

位于 static/tmpl/ 目录，提供各服务的标准配置文件模板，如：

• Nginx 虚拟主机配置
• Apache 虚拟主机配置
• PHP 配置文件
• 数据库配置文件

环境配置

支持项目级环境变量配置，自动加载项目目录下的 .env 文件。

核心技术栈

• 前端框架: Vue 3 + Element Plus + Pinia
• 构建工具: Vite + ESBuild
• 桌面框架: Electron
• 开发语言: TypeScript
• 样式方案: Tailwind CSS
• 代码编辑器: Monaco Editor

常见使用场景

创建 PHP 开发环境

1. 在 FlyEnv 界面中选择 PHP 模块
2. 安装所需 PHP 版本（支持 5.6 到 8.3）
3. 配置 Nginx 或 Apache 虚拟主机
4. 创建本地项目并配置域名

管理数据库服务

1. 启动 MySQL 或 PostgreSQL 服务
2. 通过内置工具管理数据库
3. 配置连接参数和权限

多项目环境隔离

1. 为每个项目创建独立目录
2. 配置项目特定的 PHP/NodeJS 版本
3. 使用自定义域名访问各项目

故障排除

服务启动失败

检查日志文件获取详细错误信息，通常位于应用日志目录或系统日志中。

端口冲突

FlyEnv 会自动检测端口占用情况，如遇冲突会提示更改端口配置。

权限问题

在 Linux/macOS 系统上，可能需要使用 sudo 权限安装某些依赖包。

FlyEnv 通过其全栈环境管理能力，为开发者提供了高效、一致的本地开发体验，大幅提升了开发效率和环境配置的便捷性。