# fuquOS

**Repository Path**: zhu_zonghui/fuqu-os

## Basic Information

- **Project Name**: fuquOS
- **Description**: 个人开发的操作系统内核
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-02-23
- **Last Updated**: 2026-01-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FuQu OS

[![License](https://img.shields.io/badge/license-MIT-blue.svg)  ](https://gitee.com/zhu_zonghui/fuqu-os/blob/master/LICENSE)[![Build Status](https://travis-ci.org/zhu_zonghui/fuqu-os.svg?branch=master)](https://travis-ci.org/zhu_zonghui/fuqu-os)  [![Gitee forks](https://gitee.com/zhu_zonghui/fuqu-os/badge/fork.svg?theme=dark)](https://gitee.com/zhu_zonghui/fuqu-os/members)  [![GitHub issues](https://img.shields.io/github/issues/zhu_zonghui/fuqu-os.svg)](https://gitee.com/zhu_zonghui/fuqu-os/issues)  [![Gitee stars](https://gitee.com/zhu_zonghui/fuqu-os/badge/star.svg?theme=dark)](https://gitee.com/zhu_zonghui/fuqu-os/stargazers)

注意：该md文档尚不完善，请理性参考文档内容，计划将在3周内完成基本的验证和完善，谢谢！

FuQu OS 是一个简单的操作系统项目，旨在帮助学习和理解操作系统的基本概念和实现。项目文档位于 `docs` 目录下。

> **注意：该项目仅在Ubuntu 22.4环境进行开发和测试**

## 环境部署|代码获取

> 在开始之前，请确保您的系统已安装以下工具：
>
> - `git`：好东西。
> - `make`：make 构建工具。
> - `gcc`：GNU 编译器集合。
> - `nasm`：Netwide Assembler（Netwide汇编程序）。
> - `qemu-utils`：提供 `qemu-img`工具，用于创建、转换和修改磁盘镜像。
> - `qemu-system`：QEMU（仿真器）相关支持【可以单独安装 `qemu-system-x86_64`】。

可以在Ubuntu下使用以下命令安装这些工具：

```sh
sudo apt update
sudo apt install git make gun nasm qemu-utils qemu-system
sudo apt update
```

可以在Ubuntu下使用以下命令获取代码：

```sh
# git 拉取仓库到本地
git clone https://gitee.com/zhu_zonghui/fuqu-os.git

# git 迁出目标(仓库提交记录|分支|锚点）
git checkout ...
...
```

## 构建项目

要构建 FuQu OS，请运行以下命令：

```sh
make
```

这将清理先前的构建，创建必要的目录，并生成操作系统镜像 `fuquOS.img`。

## 运行项目

要运行 FuQu OS，请使用以下命令：

```sh
make run
```

> **注意：**
>
> ~~bai-eel~~在对 `dev_idt`进行开发和测试时发现直接在**VSCode**的终端中直 `make run`运行会报错（导致无法运行），目前建议在系统终端中执行 `make run`来构建或运行项目
>
> ```sh
> qemu-system-x86_64: symbol lookup error: /snap/core20/current/lib/x86_64-linux-gnu/libpthread.so.0: undefined symbol: __libc_pthread_init, version GLIBC_PRIVATE
> ```

这将启动 QEMU 并加载生成的操作系统镜像。下面是2025/3/1 21：28的*dev_idt*分支的运行截图：

![2025/3/1 21：28时的dev_idt分支的运行截图](./docs/README.md.static/dev_idt-2025-03-01_21-27-03.png)

## 调试项目

要在调试模式下运行 FuQu OS，请使用以下命令：

```sh
make debug
```

这将启动 QEMU 并在调试模式下加载操作系统镜像，您可以使用 GDB 连接到 QEMU 进行调试。

## 清理项目

要清理生成的文件，请使用以下命令：

```sh
make clean
```

## 贡献者

感谢以下人员对该项目的贡献：

- [![创建者](https://gitee.com/zhu_zonghui)](https://gitee.com/zhu_zonghui) - 全部
- [贡献者2](https://gitee.com/white-eel) - [![Gitee forks](https://gitee.com/zhu_zonghui/fuqu-os/badge/fork.svg?theme=dark)](https://gitee.com/white-eel/fuqu-os)

感谢所有为项目作出贡献的人！