何为自律1. 为什么Cocos Creator项目需要一个像样的.gitignore
先交代一下背景。我是从Cocos Creator 1.x一路用到2.4.x的老用户，中间接手过不少团队项目，也帮人收拾过不少“git灾难现场”。最典型的场景就是：项目跑得好好的，一提交代码，仓库体积几百MB起步，同事拉下来直接卡死；或者协作时动不动就冲突，冲突文件还不是代码，而是library、temp里那些自动生成的临时json。这种时候，八成就是.gitignore没配好，或者压根没配。
Cocos Creator 2.4.13是官方2.x生命周期里比较稳定、也确实是不少上线项目在用的版本。它和3.x不一样，3.x的工程结构和资源管线改动很大，但2.4.x仍然是很多小团队、独立开发者和教学项目的首选。这个版本的工程生成目录里，library、temp、build、local这几个目录尤其容易让新手栽跟头。.gitignore说白了就是给Git立规矩，告诉它“哪些东西你不用管、不用追、不要提交”，把它写对，你的仓库就会很清爽，协作也能少掉一大半烦心事。
这篇博文就是围绕Cocos Creator 2.4.13项目的.gitignore文件内容展开，把每一行该写什么、为什么这么写、踩过哪些坑，一次性说透。不管你是刚用Git管理Cocos项目的新手，还是被仓库膨胀和冲突折磨过的老手，看完应该都能直接抄作业。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. .gitignore核心内容与逐行拆解
2.1 直接可用的.gitignore文件内容
下面这份是我基于Cocos Creator 2.4.13项目实际使用并调整过的.gitignore，不是网上随便抄的模板，每一条都有它存在的理由。你直接复制到项目根目录就能用：
gitignore复制# Library 资源导入后生成的缓存文件
/library
/temp
/local
# 构建输出目录
/build
# 原生工程相关（如果保留原生构建产物会很痛苦）
/native/engine
/native/template
# IDE/编辑器配置文件
/.idea
/.vscode
/*.code-workspace
*.iml
# 系统文件
.DS_Store
Thumbs.db
# 日志和临时文件
*.log
*.tmp
npm-debug.log*
yarn-debug.log*
yarn-error.log*
# node_modules（如果项目里装了自定义插件）
/node_modules
# 用户本地设置
/profiles
/settings
# 自定义脚本编译产物
**/bin
**/obj
这里有个容易纠结的点，就是/settings和/profiles。Cocos Creator 2.4.x启动项目后，会在项目根目录生成一个settings目录，里面存的是编辑器布局、项目设置缓存等本地个性化配置，这些不该跟着仓库走。但是settings里有个project.json，涉及项目级别的配置，个别版本会把它放在这里。我的处理方式是只要settings和profiles整体忽略，确实需要共享的配置拿出来单独追踪，比如自定义构建模板、自定义插件的配置，可以单独放到assets下的工具目录里，避免混淆。
2.2 为什么这些目录必须忽略
逐个说明这些忽略项，不是走形式，是为了让新手理解“什么文件会造成问题”，这样以后遇到新目录也能自己做判断。
先看library目录，这是重灾区中的重灾区。Cocos Creator每次导入资源时，会