Git 配置 .gitignore 文件

1、Git 设置忽略上传文件

Git 忽略文件靠 .gitignore文件实现，把需要忽略的文件 / 文件夹写进去，Git 就不会追踪、上传它们。

2、快速使用

2.1 创建忽略文件

在项目根目录 （和 .git 文件夹同级），新建一个文件，文件名必须叫 .gitignore

bash 复制代码

# 终端命令创建（推荐）
touch .gitignore

2.2 编写忽略规则

打开 .gitignore，按规则写入要忽略的内容（常用写法直接复制用）：

bash 复制代码

# --------------- 常用忽略模板 直接复制 ---------------
# 1. 忽略文件夹
node_modules/       # 前端依赖
dist/               # 打包产物
build/              # 构建目录
.idea/              # IDEA配置
.vscode/            # VSCode配置

# 2. 忽略指定文件
.env                # 环境变量（密码、密钥必忽略）
.DS_Store           # Mac系统文件
*.log               # 所有日志文件
*.tmp               # 所有临时文件

# 3. 忽略某类文件
*.zip               # 所有压缩包
*.exe               # 所有可执行文件

2.3 核心语法

写法	作用
`文件名`	忽略单个文件
`文件夹/`	忽略整个文件夹
`*.后缀`	忽略所有该后缀的文件
`!文件名`	不忽略这个文件（例外）
`# 注释`	写说明用

3、git 提交代码

自动跳过被忽略的文件

bash 复制代码

git add .
git commit -m "首次提交"

🔸 已经执行 git add . 怎么撤回？

（1）新仓库、没提交过用下面命令

bash 复制代码

git rm --cached -r .

（2）有提交过记录用下面命令

bash 复制代码

git reset HEAD .

不会删除你的代码，放心用！

4、编写忽略规则

打开创建好的.gitignore文件，按规则写入需要忽略的文件/文件夹。下面整理了最常用的忽略模板，覆盖Python、前端、通用场景，直接复制粘贴即可，无需手动编写！

bash 复制代码

# ------------------- 通用忽略规则 -------------------
# 系统文件
.DS_Store          # Mac系统自带文件
Thumbs.db          # Windows系统缩略图文件
*.tmp              # 所有临时文件
*.log              # 所有日志文件

# IDE配置文件（适用于VSCode、IDEA）
.vscode/           # VSCode配置
.idea/             # IDEA配置
*.suo              # VS相关配置
*.iml              # IDEA相关配置

# ------------------- 语言/框架专属 -------------------
# Python
__pycache__/       # Python缓存文件夹
*.pyc              # Python字节码文件
*.pyo              # Python优化字节码文件
venv/              # 虚拟环境文件夹
dist/              # 打包产物

# 前端（Vue/React等）
node_modules/      # 前端依赖包
dist/              # 打包后的静态文件
build/             # 构建目录
.env               # 环境变量文件（含敏感信息）
.env.*             # 所有环境变量相关文件

# Java
target/            # Maven/Gradle构建目录
*.jar              # Jar包文件
*.war              # War包文件