创建仓库工作流
你将构建什么
在本地创建一个新项目目录,用 git init 初始化为 Git 仓库,创建一个 README 文件,用 git add 暂存、git commit 提交,完成第一次版本记录。
学习目标
- 用 git init 把普通目录变成 Git 仓库
- 用 git add 把文件加入暂存区
- 用 git commit 把暂存内容提交到历史
- 理解工作区、暂存区、仓库区三个区域
前置要求
- 已安装 Git 并配置好用户名和邮箱
- 会用命令行创建目录和文件
- 了解版本控制的基本概念
步骤
- 1
创建项目目录并初始化仓库
在命令行中创建一个新目录 my-project,进入后运行 git init。这会在目录下创建一个 .git 隐藏文件夹,把它变成 Git 仓库。
代码mkdir my-project cd my-project git init预期结果
输出“Initialized empty Git repository”,目录下出现 .git 文件夹。
提示
git init 只需运行一次,它创建仓库的内部数据结构。.git 文件夹不要手动修改。
- 2
创建第一个文件
用编辑器或命令行创建一个 README.md 文件,写入项目名称和简介。这是项目的入口文档。
代码# 我的项目 这是一个用于练习 Git 工作流的示例项目。预期结果
目录下出现 README.md 文件,内容为标题和简介。
提示
Markdown 是项目文档的通用格式,GitHub 会自动渲染 README.md。
- 3
查看状态并暂存文件
运行 git status 查看仓库状态——README.md 应显示为未跟踪。用 git add README.md 把它加入暂存区。再次 git status 确认已暂存。
代码git status git add README.md git status预期结果
第一次 status 显示红色未跟踪,add 后显示绿色已暂存。
提示
git add . 可以暂存所有变更,但在学习阶段建议逐个 add 以理解每步操作。
- 4
完成首次提交
用 git commit -m 提交暂存内容,-m 后面是提交信息。提交信息用中文或英文简述本次变更。提交后用 git log 查看历史。
代码git commit -m "初始化项目:添加 README" git log预期结果
commit 成功后 git log 显示一条提交记录,含哈希值、作者、时间和信息。
提示
提交信息用祈使句(如“添加”而非“添加了”),简洁描述做了什么。
自己动手试试
# 在终端中逐条运行这些命令
mkdir my-project
cd my-project
git init
# TODO: 创建 README、add、commit、logmkdir my-project
cd my-project
git init
echo "# 我的项目" > README.md
git add README.md
git status
git commit -m "初始化项目:添加 README"
git log你学到了什么
你掌握了 Git 的核心工作流:init 创建仓库 → add 暂存 → commit 提交。这三个命令是日常使用频率最高的 Git 操作,理解暂存区的设计是掌握 Git 的关键。
相关资源
相关课程
- git init
学习如何初始化仓库。
- git add
学习暂存区操作。
- git commit
学习提交历史。
相关练习
- git add 选择题
测验暂存区知识。
相关工具
- .gitignore 生成器
为新仓库生成 .gitignore 文件。
- Markdown 预览器
预览 README.md 渲染后的 HTML 效果。
相关参考文档
- Git 命令参考
init、add、commit、status、log 完整参考。
相关术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
相关错误
用大白话解释常见错误——什么意思、为什么发生、如何修复。