创建仓库与第一次提交

一个 Git 仓库 = 普通项目目录 + 隐藏的 .git 文件夹。第一次提交会把当前文件快照写入历史。

学习目标

• 用 git init 创建仓库
• 理解 git add 与 git commit 的区别
• 写一句清晰的 commit message

准备练习目录

在任意位置新建空文件夹（不要在你正在协作的大项目根目录里练习 init，避免嵌套仓库混乱）：

mkdir ~/git-practice-hello
cd ~/git-practice-hello

初始化仓库

git init

会看到 Initialized empty Git repository...，目录下出现 .git/。

查看状态：

git status

输出 On branch main，且提示 nothing to commit — 还没有被跟踪的文件。

第一个文件

echo "# Hello CodeRoadMap" > README.md
git status

此时 README.md 出现在 Untracked files。Git 还不管它。

暂存与提交

git add README.md
git status

文件进入 Changes to be committed（暂存区）。

git commit -m "docs: add readme"

-m 后跟简短说明。团队里常见前缀：

前缀	含义
feat:	新功能
fix:	修复 bug
docs:	文档
chore:	构建/工具变动

再查状态：

git status

应为 nothing to commit, working tree clean — 工作区与最后一次提交一致。

查看历史

git log
git log --oneline

每条记录包含：commit id（SHA）、作者、时间、message。

修改后再提交

echo "练习 Git 第一课" >> README.md
git status        # modified: README.md
git add README.md
git commit -m "docs: extend readme"
git log --oneline

应看到两条 commit，新的在最上。

工作区 → 暂存区 → 仓库

编辑文件 (工作区)
    │ git add
    ▼
暂存区 (index)
    │ git commit
    ▼
本地仓库 (.git)

只 commit 不 add 不会包含新改动；add 后再改文件，需要再次 add 才能把最新内容放进下一次 commit。

练习

• 独立完成 init → add → commit 至少 2 次
• 用 git log --oneline 确认历史
• 故意写错 commit message，查 git commit --amend -m "新说明"（仅未 push 时使用）

小结

git init 建库，git add 选快照，git commit 写入历史。 下一课学习 git status / git log 的更多用法，以及如何用 .gitignore 排除 node_modules 等目录。