Java 后端初学者的第一个 GitHub 仓库该怎么建?从零开始完整教程

5 阅读2分钟

作为一名大二的 Java 后端方向学生,这个暑假我开始系统性地整理后端学习笔记。如果你也是刚开始学习后端、不知道怎么搭建自己的 GitHub 笔记仓库,这篇文章可以手把手带你完成。

最终效果

这是我的仓库:github.com/ypyang-code…

backend-notes/ 
├── java/basics/ # Java 基础笔记 
├── spring/ # Spring Boot、MyBatis 
├── database/ # MySQL、Redis 
├── project/ # 项目复盘 
└── interview/ # 面试八股文

Step 1:创建 GitHub 仓库

打开 github.com/new,填写:

字段建议
Repository namebackend-notes
DescriptionJava 后端学习笔记 & 项目复盘
VisibilityPublic(公开,方便面试官查看)
Add a README file✅ 勾选
Add .gitignoreJava

点击 Create repository。

Step 2:创建目录结构

GitHub 网页端不能直接建空文件夹,需要通过"创建文件"的方式:

  1. 点击 Add file → Create new file
  2. 在文件名输入框输入带斜杠的路径:java/basics/README.md
  3. 斜杠会自动创建文件夹
  4. 填写内容后点击 Commit new file

重复上述操作,创建以下目录:

  • java/basics/README.md
  • spring/spring-boot/README.md
  • database/mysql/README.md
  • project/mall-notes/README.md

Step 3:编写 README.md

仓库门面很重要,编辑仓库首页的 README.md:

# ava 后端学习笔记

> 记录 Java 后端学习过程中的知识点、项目复盘与踩坑记录。

## 目录

-   [Java 基础]()
-   [Spring Boot]()
-   [MySQL]()
-   [项目复盘]()

## 正在进行的项目

-   mall 电商系统学习笔记

## 技术博客

-   掘金:[你的掘金主页]

Step 4:提交第一篇笔记

创建 java/basics/oop.md

# java 面向对象

## 三大特性

-   封装
-   继承
-   多态

填写 Commit message:`docs: 添加 Java 面向对象笔记`,然后 Commit。

## 我的笔记写作模板

每篇笔记固定格式:

```markdown
## 标题

**日期**:2026-XX-XX  
**场景**:为什么要学这个

### 问题描述

...

### 解决方案

...

### 踩坑记录

...

## 下一步

这个暑假我的目标是:
1. 吃透 mall 电商项目
2. 完成 LeetCode 200 题
3. 每周输出 1 篇技术博客

如果你也在学 Java 后端,欢迎一起交流!