OC
让gitignore默认忽略一切之前,先确认Git还能走进你的目录
科技 · 2026-09-07 · 工程实践 · 阅读 6

让gitignore默认忽略一切之前,先确认Git还能走进你的目录

Package Main 的一篇工程文章提出,把常见的 .gitignore 思路倒过来:默认忽略所有文件,只把源代码和必要配置重新纳入。面对越来越多编辑器缓存、构建产物和代理生成文件,这个想法有吸引力,但一条 * 配几个扩展名例外,并不足以构成可靠的仓库策略。

作者:林岚|OC 开发者生态编辑

Package Main 的一篇工程文章提出,把常见的 .gitignore 思路倒过来:默认忽略所有文件,只把源代码和必要配置重新纳入。面对越来越多编辑器缓存、构建产物和代理生成文件,这个想法有吸引力,但一条 * 配几个扩展名例外,并不足以构成可靠的仓库策略。

一句话结论:默认忽略可以减少误提交,却也会增加漏提交;采用它之前,必须处理父目录规则,并让干净检出的构建成为验收条件。

最隐蔽的问题是 Git 根本没有走进去

假设仓库根目录写着:

gitignore * !.gitignore !*.go !go.mod !go.sum

根目录的 Go 文件可能被纳入,但 cmd/app/main.go 不会因为 !*.go 就自动获救。原因是 * 同时排除了父目录;Git 为了避免遍历被忽略的目录,不会继续进去发现子文件例外。

Git 官方文档对此有明确规定:父目录被排除时,无法单独重新包含其中的文件。因此,若选择“所有目录可遍历、文件按规则纳入”的策略,最小示意需要补上:

gitignore * !*/ !.gitignore !*.go !go.mod !go.sum

!*/ 的意义是允许继续遍历目录,不是把目录内所有文件都提交。一个嵌套的 .env 仍会被最前面的规则忽略;而被明确允许的 Go 文件才有机会显示为未跟踪文件。这组示意只解决遍历问题,并不是适用于所有 Go 项目的完整清单。

文件扩展名不能替团队判断项目需要什么

真实仓库除了源代码,还可能需要 SQL 迁移、模板、测试样本、许可证、持续集成配置以及嵌入资源。它们不一定遵循统一扩展名,更不会因为没有进入允许列表就变得不重要。

这会产生一种很难从个人电脑上发现的故障:本地文件齐全,程序正常运行;提交之后,同事或者 CI 只拿到版本库中的部分内容,才发现启动所需模板不见了。默认忽略把噪声藏起来的同时,也会把这种遗漏藏起来。

因此,允许列表应描述项目真正拥有的资产,而不只是“看起来像代码的文件”。团队可以按受控目录纳入资源,再对构建输出设置更具体的排除规则;也可以保留传统排除列表。选择哪一种,取决于误提交与漏提交哪类风险更突出。

忽略父目录会阻止对子文件例外规则的匹配

这不是凭据保护系统

.gitignore 主要作用于尚未跟踪的文件。已经进入 Git 索引的文件,不会因为后来加了忽略规则就自动停止跟踪。强制添加也能绕过忽略规则。Git 官方语义说明。

所以,如果某个秘密已经提交,补上一行文件名并不能撤销暴露。需要按实际泄露范围处理凭据,并单独评估仓库历史中的敏感内容。把默认忽略宣传成“从此不会泄密”,会给团队一种不成立的安全感。

相反,允许列表也可能把合法的安全配置漏掉。例如,仓库本来需要提交的扫描规则没有进入清单,CI 就未必能按团队预期执行。一个机制既可能减少风险,也可能让另一个控制点失效,这正是需要实际验证的原因。

怎么验证一条看起来正确的规则

检查时应选具体路径,而不是只看规则文本。git check-ignore -v 路径 可以帮助定位由哪条模式产生匹配;git status --ignored 能让被隐藏的文件重新进入视野。对于已经跟踪的文件,还需要查看索引状态,避免把“没有显示为未跟踪”误解成已被忽略。

在本地样例验证中,加入目录遍历例外后,嵌套 Go 文件可以被发现,而未获允许的文件仍被忽略。这个小测试确认的是 Git 的匹配行为,不证明一份真实项目清单已经完整。

更有价值的长期测试,是从干净检出启动构建和测试,不依赖开发机上残留的文件。新增一种资源时,代码评审也应检查它是否真的进入提交。忽略策略改变了默认行为,配套审查习惯必须一起改变。

关键事实

  • 方案:默认排除,再明确重新纳入。
  • 目录陷阱:被排除的父目录会阻止子文件例外生效。
  • 语义边界:忽略规则不自动处理已跟踪文件,也不是访问控制。
  • 验收方式:具体路径测试,加干净检出的构建与运行检查。

OC 判断

默认忽略适合边界清楚、资产类型受控的仓库,但没有放之四海而皆准的清单。它把维护成本从“发现新垃圾”转移到了“及时登记新资产”,这笔成本需要有人持续承担。

为什么重要

  • 对开发者:目录例外缺失会让正确代码悄悄留在本地。
  • 对团队:CI 应证明仓库自身完整,而不是借用个人工作区状态。
  • 对安全:忽略文件只能减少部分误操作,不能替代秘密扫描和凭据管理。

参考来源

相关阅读

基于标题、摘要和正文内容自动匹配。

更多科技

评论

围绕这篇文章补充信息、提出问题或分享观察。

0
暂无评论。

发表评论

继续看看 OC 用户围绕这个话题说了什么、做了什么。

相关帖子

更多

做 AI 语音产品时,授权、撤回和审计日志应该怎么落地?

<p>最近看到越来越多关于声音授权的讨论。对开发者来说,真正麻烦的往往不是“模型能不能模仿”,而是授权如何进入系统、生成结果如何追溯,以及授权撤回后该怎么办。</p> <p>我们在做 FlowSpeech 时也碰到过类似问题。我的体会是,不要把“用户勾选过同意”当成一个布尔字段,而应该把它做成一组可以审计的业务对象。</p> <h2>1. 把声音资产和授权分开</h2> <p>声音文件只描述技术属性,例如哈希、上传者、存储位置和创建时间。授权记录则至少要包含授权主体、用途范围、地域、有效期、来源证据和当前状态。这样同一份声音用于个人试听、商业广告、公开播客时,可以绑定不同的授权,而不是共用一个模糊的 consent=true。</p> <h2>2. 每次生成都保存授权快照</h2> <p>生成任务不要只引用当前授权 ID。授权内容以后可能变更,如果任务只查最新状态,历史结果就无法解释。更稳妥的做法是在任务创建时保存授权版本、文本哈希、声音版本、模型版本和操作者。生成出的音频再记录 artifact_id,并反向关联任务。</p> <p>我会把最小链路设计成:</p> <ol> <li>voice_asset:原始声音及版本;</li> <li>consent_grant:授权范围与证据;</li> <li>generation_job:请求参数和授权快照;</li> <li>audio_artifact:输出文件、校验值和公开状态;</li> <li>audit_event:谁在什么时候创建、下载、公开或撤回了内容。</li> </ol> <h2>3. 撤回不是简单删除一行</h2> <p>授权撤回后,系统至少要阻止新任务,并把相关公开音频进入下架队列。已经交付给客户的文件是否能删除,要按照合同和产品能力区分,不能在界面上承诺技术上做不到的“全球删除”。更现实的状态机是 active、suspended、revoked、expired,并明确每个状态允许哪些动作。</p> <h2>4. 对外展示也要可验证</h2> <p>除了后台日志,公开音频最好带上来源标记或可查询的生成记录。水印不是万能方案,但“可识别的音频 + 可验证的元数据 + 清晰的举报入口”组合起来,比一句“AI 生成”更有用。</p> <p>我们现在做的 <a href="https://flowspeech.io/zh">FlowSpeech</a> 主要解决上下文感知、情绪和停顿控制。越往产品化走,越觉得声音效果只是前半程,权限边界和可追溯性才决定这类工具能不能长期使用。</p> <p>大家在实际项目里会把授权证据放在业务数据库、对象存储,还是单独的审计系统?如果授权撤回,你们通常怎么处理已经生成并交付的音频?</p>

FlowSpeech 0 1

奉劝大家不要移民了

<p>对于大多数人而言,移民就是悲剧。实在看不下去了,大家不要往火坑里面跳。 国内发展那么快,你出国去慢车道,消费又高,又存不下钱,又要拼命适应当地环境,何苦? 老老实实在大城市找工作,根据收入买房子上车就好。</p> <p>补充:大城市觉得房价太高太辛苦,就好好学好英语,美国远程回老家省会城市,拿同比一线的收入,三线城市的开销,岂不美哉?</p> <p>转文章: <a href="https://mp.weixin.qq.com/s?__biz=MzAxNTMxMTc0MA==&amp;mid=2651016481&amp;idx=1&amp;sn=6bde227438ea02e3da3673295821692e&amp;chksm=80721b32b705922448a9f8645e8d1a8450e57151b71e58beb64e0addf9485ad0b256a431d68b&amp;mpshare=1&amp;scene=1&amp;srcid=0530QgwbtdDlMP4ZG7Nkonpo&amp;pass_ticket=bz%2FdHaz2YWQrgwhgQlVVXt866SMnyXU53Dd0OzDmMc1uZeu0PqND%2FjdQ6fQk8Bdl#rd"> 中产阶级的地雷阵 #D03 </a></p> <p>更多文章:<a href="https://mp.weixin.qq.com/s?__biz=MzAxNTMxMTc0MA==&amp;mid=503532389&amp;idx=1&amp;sn=84ff5eefb88e1b17f9ec0efb0238140d&amp;chksm=00721d76370594601903172e49477ce0ed149a3ba1bdcb88a300b55c8c552a79ea31134216ae&amp;mpshare=1&amp;scene=1&amp;srcid=0719VQx1dNX5rlraUqjWtCFm&amp;pass_ticket=bz%2FdHaz2YWQrgwhgQlVVXt866SMnyXU53Dd0OzDmMc1uZeu0PqND%2FjdQ6fQk8Bdl#rd">列表</a></p>

halida 198 9

你们的Codex额度提前耗完了没?戒断反应如何?

<p>我在第三天就消耗了只剩1%,忍了一天,然后今天干脆用这最后的1%,开着5.6 Sol 极高 强推我一个提示词笔记本应用的功能落地。最终用时3小时,居然还是跑完了。但是现在还是出现一些戒断反应,感觉啥也做不了,就无精打采的,困。</p> <p>我做了一个Prompt Notebook,专门用来收藏或者记录自己手搓的生图提示词。带Chrome一键收藏插件。支持AI优化提示词。支持提示词中提取常用字段作为提示词百科词汇。也自带生图功能用来测提示词。但是要搭配Cloudflare R2+Worker的图床。</p> <p>今天主要是做一个AI模特的资产库。将常用的AI模特固定下来,进行身份设定,以及模特的一些角色定妆图。之后生图可以直接调用AI模特自动作为垫图。</p> <p>这是AI模特资产库的界面: <img src="/upload/thread/202608/42b5f73e-938f-45de-b74e-da69da9d72a8.webp" alt="1bb0d28b-c7dd-4327-bafa-26b60323cbed" /> 这是主界面的提示词瀑布流,支持关键词或标签搜索: <img src="/upload/thread/202608/3e15b6e7-345f-48b4-aeff-1bbd89afe9d3.webp" alt="ab998e2f-9ccc-4173-832f-223aa6c6fa81" /> 这是提示词笔记的预览界面,可以复制提示词,分享提示词,点击分享还有分享短链:(https://prompt.jintao.co.uk/share/20260806LfsmY) <img src="/upload/thread/202608/bab31972-0468-4582-b873-6309233254a6.webp" alt="20260806-201213" /> 可惜现在没额度了,我又不想换模型折腾。现在还有些界面细节和小功能需要落地完善,可能还要虫子要抓。弄好了,打算放GitHub开源。</p> <p>有朋友想试试的么?</p>

shynloc 2 4

一个体会,Codex 这种现代 Agent,每天一个变,几天不用就有新惊喜

<p>当然我说的也包括 Claude Code,新功能日新月异,还有就是 AI 能力提升以后,可以做的东西日新月异。还有各种工作流方法日新月异。</p> <p>更好玩的是,我最近经历过很多次,你跟人介绍现在 Codex 可以做到什么样子,他们都觉得很厉害。但是你现场一演示,他们的震撼就更加完全不同了。所以,这种东西,需要大量的 Workshop 去沟通交流,光看文字很难讲清楚,直播、视频也越来越重要了。</p>

tinyfool 1 89