Sourcetree——使用.gitignore忽略文件或者文件夹

一、为何需要文件忽略机制？

1.1 为什么要会略？

对于开发者而言，明智地选择忽略某些文件类型，能带来三大核心优势：

仓库纯净性：避免二进制文件、编译产物等污染代码库
安全防护：防止敏感信息（如API密钥、数据库凭证）意外泄露
效率提升：减少无意义的版本追踪，加速克隆和拉取操作

1.2 通常忽略那些文件？

典型需忽略文件类型

文件类别	常见示例
系统生成文件	`.DS_Store`、`Thumbs.db`、`Desktop.ini`
编译产物	`.class`（Java）、`.o`（C++）、`*.pyc`（Python）、`/dist/`目录
依赖管理目录	`node_modules/`、`vendor/`、`target/`
开发环境文件	`.idea/`、`.vscode/`、`.env`
日志与临时文件	`.log`、`.tmp`、`npm-debug.log*`

示例：

我只修改了.cmd文件，但提交修改的时候，有很多编译产物

二、.gitignore配置深度解析

2.1 文件作用域与优先级

# 层级生效机制（从上到下优先级递减）
1. 项目根目录/.gitignore # 作用于整个项目
2. 子目录/.gitignore # 作用于该目录及其子目录
3. $GIT_DIR/info/exclude # 本地仓库级配置
4. ~/.gitignore_global # 全局配置（需执行git config --global core.excludesfile ~/.gitignore_global）

2.2 高级语法规则

# 基础匹配
*.log # 所有.log文件
!error.log # 排除规则（保留error.log）

# 目录匹配
build/ # 忽略所有build目录
doc/*.txt # 忽略doc目录下txt文件（不递归子目录）

# 通配符扩展
temp? # 匹配temp后接一个字符的文件（如tempa、temp1）
config.[tj]s # 匹配config.ts和config.js

# 注释与范围
[0-9].csv # 匹配数字开头的csv文件
# 重要：不要提交密钥文件
secret.key

.gitignore 的规则是从上到下逐行匹配的，后面的规则可以覆盖前面的规则。

否定规则（!）是唯一可以覆盖前面忽略规则的方式。

三、Sourcetree的可视化设置

3. 1首次提交.gitignore

3.1.1点击设置

3.1.2在仓库设置中选择高级，点击编辑。

3.3.3在gitignore中添加需要忽略的文件。

可以使用gitignore.io生成模板

以下是一个常用的.gitignore文件模板，可根据个人项目需求，按照.gitignore配置的语法规则2.2，进行增删改查。

# macOS system files
.DS_Store
.AppleDouble
.LSOverride
Icon
._*# IDE - IntelliJ IDEA
.idea/
*.iml
*.iws
*.ipr
out/
.idea_modules/# IDE - VSCode
.vscode/
*.code-workspace# Obsidian files
.obsidian/# Compiled files
*.class
*.jar
*.war
*.ear
*.zip
*.tar.gz
*.rar# Logs and databases
*.log
*.sqlite
*.db# Node
node_modules/
npm-debug.log*
yarn-debug.log*
yarn-error.log*# Python
__pycache__/
*.py[cod]
*$py.class
.Python
env/
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
sdist/
var/
wheels/
*.egg-info/
.installed.cfg
*.egg# Temporary files
*.swp
*.swo
*~

然后重新提交就好啦，这里.gitignore文件也要提交。

一定注意.gitignore文件要提交成功下次才能忽略设置的文件或目录！

3.2对于已经被git追踪的文件

如果是第一次提交，就会发现忽略文件已经没有了，不是第一次的这个时候你要是提交，就会发现你想要忽略的文件要是有改动，依然让你提交，这是因为这些文件已经加入git的版本控制库了，仅仅添加.gitignore文件是不够的，需要先清除缓存才行。

3.2.1清除Git缓存：

# 删除Git缓存（不会删除实际文件）
git rm -r --cached .

3.2.2 添加新的.gitignore文件，提交更改

# 添加.gitignore文件到Git
git add .gitignore# 添加其他文件
git add .# 提交更改
git commit -m "Add .gitignore file and remove ignored files from git"

3.3.3 推送到远程仓库

# 推送到远程仓库
git push origin master  # 或者其他分支名

示例问题解决：（这里我尝试修改了其他文件）

参考连接：

1.【Git】如何添加和更新.gitignore文件_git添加ignore-CSDN博客

2.Sourcetree软件中添加git的.gitignore文件忽略某些文件提交_sourcetree忽略文件-CSDN博客