如何为 first-contributions 项目创建 .gitignore 文件避免缓存文件、日志和敏感配置被提交【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions在 first-contributions 这样的文档型开源仓库里协作时本地编辑产生的缓存、日志、环境变量文件很容易混进暂存区甚至被一并提交。.gitignore文件告诉 Git 哪些文件和目录不需要纳入版本控制把这类文件排除在跟踪之外可以避免仓库里出现无关内容也能防止个人配置例如 API 密钥、环境变量被误提交。本文基于仓库自带的 Creating a .gitignore file 文档说明如何为项目创建.gitignore并处理文件已经被提交过的补救情况。先分清哪些文件不该进版本控制按文档的说法以下几类文件不应被纳入版本控制临时文件或系统生成的文件缓存、构建产物、日志体积大且可以重新安装的依赖目录例如node_modules个人或敏感配置例如 API 密钥、环境变量文件IDE 或编辑器特有的文件例如.vscode/、.idea/。忽略这些文件能让仓库保持干净、减少冲突同时避免安全风险。在项目根目录创建 .gitignore操作步骤就三步在项目根目录新建一个名为.gitignore的文本文件每行写一条要忽略的文件或目录名保存文件。基本语法只有三条规则*通配符用于匹配多个文件/指定相对于.gitignore所在位置的的路径#注释行。文档给出的完整示例如下# Ignore Mac system files .DS_Store # Ignore dependency folders node_modules/ venv/ # Ignore log and cache files *.log .cache/ # Ignore environment files .env # Ignore all text files *.txt这个示例里的缓存、日志、环境文件三类规则正好对应标题中要规避的几类内容*.log与.cache/排除日志和缓存.env排除敏感的环境配置。需要注意两点这是文档示例规则应按项目实际情况增删。例如*.txt会忽略所有文本文件如果仓库里需要提交.txt文档就不要照抄这一条仓库根目录已经存在一份 .gitignore可以直接参考其中已启用的条目例如.DS_Store、.idea/、.vscode、.env、*.log、node_modules/、*.binlog以及带#的注释分组方式。可选配置全局 .gitignore如果希望同一批忽略规则个人目录、编辑器文件等在所有仓库生效而不仅仅作用于 first-contributions可以配置一个全局排除文件git config --global core.excludesfile ~/.gitignore_global之后编辑~/.gitignore_global的方式和本地.gitignore完全相同。这是可选项只需要本项目生效时只维护项目根目录的.gitignore即可。文件已被提交时取消跟踪.gitignore只对未跟踪的文件生效。如果某个文件在写入.gitignore之前就已经提交过必须先把它从 Git 跟踪中移除本地文件保留取消跟踪单个文件git rm --cached filename这里的filename换成实际文件名。--cached的作用是按 Removing a File 文档的说明Git 从此不再跟踪该文件的变更相当于Git 认为这个文件被删了但它仍然留在你的文件系统中。如果漏掉了--cachedGit 会连文件系统中的文件一起删除。该文档还给出两种批量写法git rm file1.js file2.js file3.js --cached git rm *.txt --cached按文档示例多个文件可以写在同一条命令里也可以用通配符一次移除相似文件。执行后用git commit -m Remove file1.js提交、git push origin main或你当前所在分支推送到远端远端仓库中的该文件才会被移除。如果误执行了git rm --cached filename用下面这条命令即可恢复跟踪git add filename验证与限制文档给出的核对路径如下取消跟踪后在文件系统中查看该文件文件仍然存在只是不再出现在 Git 的跟踪列表里提交并推送后远端仓库中对应文件被移除。这是取消跟踪生效的判定依据。对于尚未跟踪的文件把规则写入.gitignore并保存后文件就不再会被 Git 跟踪——这正是创建.gitignore的预期结果。两个边界要注意全局.gitignore作用于该 Git 用户的所有仓库修改前确认不会误伤其他项目本文只覆盖创建.gitignore与取消跟踪两个环节first-contributions 的完整贡献流程fork、分支、提交 PR请继续参考仓库根目录的 README 和 Additional Material 索引。【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
