很多人第一次用 Git 时，都会遇到一个很尴尬的问题：明明已经写了 .gitignore，为什么文件还是被提交上去了？

比如：

node_modules/
.env
dist/

看起来没毛病，对吧？

可现实往往是：node_modules 还在 Git 里，.env 也已经被提交过，甚至团队成员一拉代码，发现你的本地配置、日志文件、构建产物全都混进了仓库。

.gitignore 是 Git 里非常基础的文件，但它背后的规则并不总是直觉化。今天这篇文章，我们就用最接地气的方式，把 .gitignore 的写法、常见坑和最佳实践一次讲清楚。

命令速查表

摘要

很多人觉得 Git 难，其实真正高频使用的命令可能只有几个。别一上来学分支和工作流，先完成你的第一次提交。代码管理的第一步，不是复杂，而是开始。

命令速查表

git --version
# 查看 Git 是否安装成功

git config --global user.name "你的名字"
# 配置 Git 用户名

git config --global user.email "你的邮箱"
# 配置 Git 邮箱

cd git-demo
# 进入项目目录

git init
# 初始化 Git 仓库

git add hello.txt
# 添加指定文件到暂存区

git ...