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

比如：

node_modules/
.env
dist/

看起来没毛病，对吧？

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

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

命令速查表

很多人在开发时，都会遇到这样一种情况：

• 已经写了一堆代码
• 项目文件夹已经存在
• 但还没有使用 Git 管理
• 想上传到 GitHub / GitLab
• 或者后续想多人协作

这时候最常见的问题就是：

“如何把一个已有代码目录，配置成 Git 仓库？”

今天这篇文章，就带你完整走一遍。

适合：

• Python / Java / 前端 / AI 项目
• 个人项目
• 公司项目
• 本地已有代码目录

全部通用。

一、什么是 Git 仓库？

简单理解：

Git 会在你的项目里创建一个：

.git/

隐藏目录。

这个目录会记录：

• 代码历史
• 修改记录
• 分支信息
• 提交版本
• 回滚信息

也就是说：

...