Czkawka 重复文件与相似图片扫描器开源贡献指南从本地跑通到合并第一个 PR【免费下载链接】czkawkaMulti functional app to find duplicates, empty folders, similar images etc.项目地址: https://gitcode.com/GitHub_Trending/cz/czkawkaCzkawka 是一个用 Rust 编写的多平台文件清理工具能扫描并整理重复文件、空文件夹、相似图片、相似视频等。这份 Czkawka 开源贡献指南写给新手如果你正在琢磨如何参与 Czkawka 开源开发答案就在这里。项目是一个核心库 三个前端桌面、命令行、Android的结构代码规范写得很清楚你的改动容易看懂也容易被评审。第一次贡献可以小到改一句话本文的目标是带你从跑通本地环境一路走到提交第一个 PR。 选一条贡献赛道六种方式对照动手前先对号入座。下表按上手难度排列了常见贡献方式你可以按时间和背景挑一条方式你在做什么门槛耗时报 Bug在界面或命令行复现问题并写好报告低约 20 分钟改文档修正 instructions/ 里的错误、补充示例低约 30 分钟分享用法示例把你的命令行自动化用法整理出来中低约 1 小时补翻译补充英文 Fluent 源文件里的漏翻词条中1–2 小时提代码用 Rust 改 czkawka_core/ 或某个前端中高半天到几天性能与测试加基准测试或单元测试高几天第一次做新手贡献从前两行开始最稳本地跑通之后再试代码类的 PR。️ 一条命令跑起本地环境先装好两样东西较新的 Rust 工具链项目要求 1.94.1 以上和just命令运行器。之后基本都能用命令搞定git clone https://gitcode.com/GitHub_Trending/cz/czkawka cd czkawka just run krokiet # 跑起主桌面界面 just fix # 格式化 clippy 脚本检查 just test # 跑全部测试仓库结构值得先记住czkawka_core/是共享扫描引擎krokiet/是主力桌面界面czkawka_cli/是命令行版cedinia/是安卓版misc/放工具脚本。业务逻辑集中在核心库多数改动只碰一两个文件。 走通你的第一个 PR最典型的路径是代码贡献四步git checkout -b fix/your-branch # 建特性分支 # 改代码并补上测试然后本地验证 just fix just test git push origin fix/your-branch推送后开一个 PR用英文写清楚它解决了什么问题。其余路径各说几句报 Bug 要写复现步骤、预期与实际行为、环境信息发帖前先搜已有 Issueinstructions/FAQ.md 汇集了历史上 1200 多个 issue 的高频问题改文档最简单直接在instructions/下修改后提交翻译只动i18n/en/下的英文源文件其他语言走项目集中翻译流程仓库里的其他语言文件不要直接改。✅ 合并前自查 6 项项目有硬性基线just fix必须干净跑完它一次跑完格式化、clippy 和死代码检查。提交 PR 前逐项核对代码、注释、commit 信息全英文一次提交只做一件事just fix无输出通过just test全绿新逻辑补了单元测试断言用显式的assert_eq!测试之外不写unwrap()不静默吞掉错误代码和提交信息里不用 — – 破折号单个源文件不超过 500 行没动过非英文翻译文件改到哪个子项目就先读它的专属规范比如 krokiet/AGENTS.md里面有该目录的回调模式和约定。 找到人三个入口拿不准的地方去 Issue 区讨论发帖前先搜有没有人问过同样的问题。对功能设计有疑问先在 Issue 里把你的想法说出来再动手写代码。每个 PR 都会经过维护者评审你按评审意见改完就是项目历史的一部分。合并代码的贡献者会被项目记录署名。现在就打开终端克隆仓库并跑一次just test——测试全绿你的本地环境就准备好了距离第一次贡献只差一个 Issue。【免费下载链接】czkawkaMulti functional app to find duplicates, empty folders, similar images etc.项目地址: https://gitcode.com/GitHub_Trending/cz/czkawka创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考