mirror of
https://github.com/lobehub/lobehub
synced 2026-04-21 17:47:27 +00:00
3dfc86fd0f
* feat: Redesign doc
* chore: uopdate site
* chore: uopdate site
* chore: uopdate site
* chore: uopdate site
* chore: uopdate site
* feat: Uopdate content
* chore: New doc
* chore: Update content
* chore: Update content
* chore: add images
* chore: add images
* chore: add images
* chore: add images
* feat: Add more images
* feat: Add more images
* fix: Cannot reach end
* chore: Update content
* chore: Update content
* chore: Update content
* chore: Update content
* chore: Update content
* Revise README content and structure
Updated README to reflect changes in project description and removed outdated notes.
* Revise 'Getting Started' and TOC in README
Updated the 'Getting Started' section and modified the table of contents.
* chore: Update content
* Revise README structure and content
Updated the Getting Started section and removed the Table of Contents. Adjusted the Local Development instructions.
* Remove custom themes section from README
Removed section about custom themes from README.
* Update README.md
* Refine introduction and highlight cloud version
Updated wording for clarity and added recommendation for cloud version.
* chore: Update content
* chore: Update content
* chore: Update content
* chore: Update content
* chore: Update content
* chore: Update content
* chore: Update content
* fix: add missing translation
* 🔀 chore: Move README changes to feat/readme branch
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: add missing translation
* chore: update cdn
* docs: add migration guide from v1.x local database to v2.x and update help sections
Signed-off-by: Innei <tukon479@gmail.com>
* fix: add missing translation
* fix: add missing images
* fix: add missing changelogs
* fix: add missing changelogs
* fix: add missing changelogs
* fix: add missing changelogs
* fix: add missing changelogs
* style: update cdn
---------
Signed-off-by: Innei <tukon479@gmail.com>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: canisminor1990 <i@canisminor.cc>
Co-authored-by: Innei <tukon479@gmail.com>
82 lines
2.8 KiB
Text
82 lines
2.8 KiB
Text
---
|
||
title: 环境设置指南
|
||
description: 详细介绍 LobeHub 的开发环境设置，包括软件安装和项目配置。
|
||
tags:
|
||
- LobeHub
|
||
- 开发环境
|
||
- Node.js
|
||
- PNPM
|
||
- Git
|
||
---
|
||
|
||
# 环境设置指南
|
||
|
||
欢迎阅读 LobeHub 的开发环境设置指南。
|
||
|
||
## 在线开发
|
||
|
||
如果你有 GitHub Codespaces 的使用权限，可以点击下方按钮一键进入在线开发环境：
|
||
|
||
[![][codespaces-shield]][codespaces-link]
|
||
|
||
## 本地开发
|
||
|
||
在开始开发 LobeHub 之前，你需要在本地环境中安装和配置一些必要的软件和工具。本文档将指导你完成这些步骤。
|
||
|
||
### 开发环境需求
|
||
|
||
首先，你需要安装以下软件：
|
||
|
||
- Node.js：LobeHub 是基于 Node.js 构建的，因此你需要安装 Node.js。我们建议安装最新的稳定版。
|
||
- PNPM：我们使用 PNPM 作为管理器。你可以从 [pnpm 的官方网站](https://pnpm.io/installation) 上下载并安装。
|
||
- Bun：我们使用 Bun 作为 npm scripts runner, 你可以从 [Bun 的官方网站](https://bun.com/docs/installation) 上下载并安装。
|
||
- Git：我们使用 Git 进行版本控制。你可以从 Git 的官方网站上下载并安装。
|
||
- IDE：你可以选择你喜欢的集成开发环境（IDE），我们推荐使用 WebStorm/VSCode。
|
||
|
||
### VSCode 用户
|
||
|
||
推荐安装 [.vscode/extensions.json](https://github.com/lobehub/lobe-chat/blob/main/.vscode/extensions.json) 中推荐安装的扩展获得最佳开发体验。
|
||
|
||
### 项目设置
|
||
|
||
完成上述软件的安装后，你可以开始设置 LobeHub 项目了。
|
||
|
||
1. **获取代码**：首先，你需要从 GitHub 上克隆 LobeHub 的代码库。在终端中运行以下命令：
|
||
|
||
```bash
|
||
git clone https://github.com/lobehub/lobe-chat.git
|
||
```
|
||
|
||
2. **安装依赖**：然后，进入项目目录，并使用 `pnpm` 安装项目的依赖包：
|
||
|
||
```bash
|
||
cd lobe-chat
|
||
pnpm i
|
||
```
|
||
|
||
3. **启动开发服务器**：安装完依赖后，你可以启动开发服务器：
|
||
|
||
```bash
|
||
bun run dev
|
||
```
|
||
|
||
现在，你可以在浏览器中打开 `http://localhost:3010`，你应该能看到 LobeHub 的欢迎页面。这表明你已经成功地设置了开发环境。
|
||
|
||
|
||
|
||
## 使用服务端功能
|
||
|
||
上述基础设置使用 LobeHub 的客户端数据库模式。如果你需要开发服务端功能，如：
|
||
|
||
- 数据库持久化
|
||
- 文件上传和存储
|
||
- 图像生成
|
||
- 多用户身份验证
|
||
- 高级服务端集成
|
||
|
||
请参考[使用服务端数据库](/docs/development/basic/work-with-server-side-database)指南获得完整的设置说明。
|
||
|
||
在开发过程中，如果你在环境设置上遇到任何问题，或者有任何关于 LobeHub 开发的问题，欢迎随时向我们提问。我们期待看到你的贡献！
|
||
|
||
[codespaces-link]: https://codespaces.new/lobehub/lobe-chat
|
||
[codespaces-shield]: https://github.com/codespaces/badge.svg
|