.gitignore
Git 用于指定忽略文件和目录模式的配置文件,防止敏感或无关文件被意外提交到仓库
核心事实
时间轴 (近 90 天)
开发者应将 settings.local.json 及相关本地配置文件加入 .gitignore。
AI 编码工具的配置文件(如 claude.json、.claude/settings.local.json)常使用非标准命名,尚未被广泛纳入主流 .gitignore 模板,导致开发者容易遗漏排除。
提交前应使用 git status 和 git diff --cached 确认暂存内容,在仓库中搜索 password、api_key、secret、token 等关键词,用 .gitignore 排除 .env 等文件,启用 GitHub Secret Scanning 或 pre-commit 钩子,并尽量用环境变量或密钥管理服务替代硬编码。
Claude Code仅将.claude-settings.local.json加入用户的全局Git忽略列表(Global Git Excludes),而不会将其加入项目本身的.gitignore,因此该文件仍可能被纳入版本控制。
开发者应谨慎使用「Don't Ask Again」选项,尤其是在包含敏感配置的项目中,尽量保持逐次确认的习惯;同时将 .env、密钥文件等加入 .gitignore 并定期审查公开仓库。
用户级指令文件(如 `~/.claude/CLAUDE.md`)建议在 `.gitignore` 中排除,仅提交项目根目录下的共享文件。
将 .env 文件添加到 .gitignore 可防止其被意外提交,但如果 .env 文件已被跟踪或已提交到历史记录,仅添加 .gitignore 不足以移除它,需要使用 git rm --cached 停止跟踪并可能需用 git filter-branch 或 BFG Repo-Cleaner 清理历史。
在 Bolt.new 项目根目录创建 .bolt/ignore 文件(语法类似 .gitignore),可让上下文索引器不读取指定文件,实测使单次提示上下文重量下降 35% 到 50%。
项目根目录的 .gitignore 随代码一起提交,团队成员共享同一套忽略规则
Git 提供三个忽略文件:项目级 .gitignore、全局 core.excludesFile、本地 .git/info/exclude
还有 6 条时间轴事件
全部知识事实 (18)
Git 提供三个忽略文件:项目级 .gitignore、全局 core.excludesFile、本地 .git/info/exclude
65%待验证Cursor的.cursorignore文件设计灵感来源于Git的.gitignore机制,两者共享相同的glob语法规范
85%待验证开发者应将 settings.local.json 及相关本地配置文件加入 .gitignore。
50%待验证AI 编码工具的配置文件(如 claude.json、.claude/settings.local.json)常使用非标准命名,尚未被广泛纳入主流 .gitignore 模板,导致开发者容易遗漏排除。
50%待验证提交前应使用 git status 和 git diff --cached 确认暂存内容,在仓库中搜索 password、api_key、secret、token 等关键词,用 .gitignore 排除 .env 等文件,启用 GitHub Secret Scanning 或 pre-commit 钩子,并尽量用环境变量或密钥管理服务替代硬编码。
50%待验证Claude Code仅将.claude-settings.local.json加入用户的全局Git忽略列表(Global Git Excludes),而不会将其加入项目本身的.gitignore,因此该文件仍可能被纳入版本控制。
50%待验证开发者应谨慎使用「Don't Ask Again」选项,尤其是在包含敏感配置的项目中,尽量保持逐次确认的习惯;同时将 .env、密钥文件等加入 .gitignore 并定期审查公开仓库。
50%待验证用户级指令文件(如 `~/.claude/CLAUDE.md`)建议在 `.gitignore` 中排除,仅提交项目根目录下的共享文件。
50%待验证将 .env 文件添加到 .gitignore 可防止其被意外提交,但如果 .env 文件已被跟踪或已提交到历史记录,仅添加 .gitignore 不足以移除它,需要使用 git rm --cached 停止跟踪并可能需用 git filter-branch 或 BFG Repo-Cleaner 清理历史。
50%待验证在 Bolt.new 项目根目录创建 .bolt/ignore 文件(语法类似 .gitignore),可让上下文索引器不读取指定文件,实测使单次提示上下文重量下降 35% 到 50%。
50%待验证项目根目录的 .gitignore 随代码一起提交,团队成员共享同一套忽略规则
50%待验证把个人编辑器配置写进项目 .gitignore 是一种常见但不够优雅的做法,会让共享文件逐渐膨胀
50%待验证'默认忽略一切'白名单模式通过 * 忽略所有文件,再用 ! 前缀规则显式加回需要跟踪的文件
50%待验证.gitignore 规则按从上到下顺序逐行处理,后出现的规则会覆盖前面的规则
50%待验证白名单模式的主要缺点是每次新增一种文件类型都需要手动更新 .gitignore,增加维护成本
50%待验证数据科学与机器学习项目适合白名单式 .gitignore,数据和模型宜通过 DVC 等专用工具管理
50%待验证传统 .gitignore 采用黑名单模式,默认所有文件都会被跟踪,只列出需排除的例外
50%待验证即便开发者在发现硬编码密钥后立即删除并重新提交,密钥依然存在于Git的提交历史中,可通过git log或git show命令找回
50%