关键词:.gitignore、Git 忽略规则、技术栈勾选、纯前端、JavaScript、版本控制
一、背景与需求
在使用 Git 进行版本控制时,.gitignore 文件用于告知 Git 哪些文件或目录不应被追踪。正确配置 .gitignore 可以避免将依赖目录、编译产物、日志文件、环境变量文件等不应提交的内容纳入版本控制,保持仓库整洁。
但手动编写 .gitignore 存在以下痛点:
- 不同语言和框架的忽略规则各不相同,开发者需要反复查阅文档或从其他项目复制;
- 容易遗漏某些常见产物(如
.DS_Store、node_modules/、target/、.env等); - 多技术栈混合项目(如前后端分离)需要合并多个规则集,手动合并容易出错;
- 部分在线生成工具需要注册登录,或将选择的技术栈上传到服务器,项目技术栈信息泄露风险较高。
基于此,我开发了 Toolion .gitignore 生成器(https://toolion.cn/gitignore-generator/),一款纯前端的 .gitignore 文件生成工具,支持按编程语言和框架勾选生成,全部处理在浏览器本地完成,无需登录,免费使用。

二、核心功能
| 功能模块 | 说明 |
|---|---|
| 按技术栈勾选 | 支持操作系统、编辑器/IDE、前端、后端、移动端、环境与配置六大类,共计数十种技术栈 |
| 全选与清空 | 一键全选所有技术栈,或清空当前选择 |
| 实时生成 | 勾选变化后立即生成 .gitignore 内容,右侧实时预览 |
| 一键复制 | 将生成的内容复制到剪贴板,支持 navigator.clipboard 与 execCommand 降级 |
| 文件下载 | 将生成的内容下载为 .gitignore 文件,文件名固定为 .gitignore |
| 默认勾选 | 页面加载时自动勾选 Node.js、macOS、Windows、Env 文件等常用项 |
| 纯前端本地处理 | 所有规则拼接与生成在浏览器内完成,不上传任何数据,支持离线运行 |
| 免费无需注册 | 打开页面即可使用,无登录、无订阅、无水印 |
| 深色/浅色主题 | CSS 变量适配深色模式,状态持久化到本地存储 |
三、技术实现
3.1 整体架构
该工具是一个纯前端单页面应用(单 HTML 文件),未引入 Vue/React 等前端框架,全部逻辑使用原生 JavaScript 实现:
浏览器端(纯原生 JavaScript)
├── 数据层:TEMPLATES 规则库(6 大类、数十种技术栈、数百条忽略规则)
├── 输入层:复选框勾选面板(分类标题 + 复选框网格)、全选/清空按钮
├── 生成层:按勾选项拼接 `.gitignore` 内容(带分类标题注释与空行分隔)
├── 输出层:结果文本框、复制按钮、下载按钮(生成 Blob + URL.createObjectURL)
└── 渲染层:勾选 UI 状态(checked 类)、按钮禁用状态、深色/浅色主题
3.2 规则库设计
规则库 TEMPLATES 按类别组织,每个类别下包含多种技术栈,每种技术栈对应一组忽略规则数组:
const TEMPLATES = {
'操作系统': {
'macOS': ['.DS_Store', '._*', '.Spotlight-V100', '.Trashes', 'ehthumbs.db', 'Thumbs.db'],
'Windows': ['Thumbs.db', 'ehthumbs.db', 'Desktop.ini', '$RECYCLE.BIN/', '*.cab', '*.msi', '*.msm', '*.msp'],
'Linux': ['*~', '.directory', '.fuse_hidden*', '.Trash-*']
},
'编辑器/IDE': {
'VS Code': ['.vscode/', '!.vscode/extensions.json', '!.vscode/settings.json'],
'IntelliJ IDEA': ['.idea/', '*.iml', '*.iws', '*.ipr', 'out/', '.idea_modules/'],
'Vim': ['*.swp', '*.swo', '*~', '.vim/'],
'Sublime Text': ['*.sublime-workspace', '*.sublime-project'],
'Eclipse': ['.metadata/', 'bin/', 'tmp/', '*.tmp', '*.bak', '*.swp', '.classpath', '.project', '.settings/']
},
'前端': {
'Node.js': ['node_modules/', 'npm-debug.log*', 'yarn-debug.log*', 'yarn-error.log*', 'pnpm-debug.log*', '.pnpm-debug.log*', 'lerna-debug.log*', '.npm', '.eslintcache', '.nyc_output'],
'React/Vue/Next.js': ['.next/', 'out/', 'build/', 'dist/', '.cache/', '.temp/', '.nuxt/', '.vuepress/dist/', '.docusaurus/'],
'Vite': ['.vite/', 'dist-ssr/'],
'Yarn / NPM': ['.yarn/*', '!.yarn/patches', '!.yarn/releases', '!.yarn/plugins', '!.yarn/sdks', '!.yarn/versions']
},
'后端': {
'Python': ['__pycache__/', '*.py[cod]', '*$py.class', '*.so', '.Python', 'build/', 'develop-eggs/', 'dist/', 'downloads/', 'eggs/', '.eggs/', 'lib/'
转载自 CSDN-专业IT技术社区
原文链接:https://blog.csdn.net/Zaninho14/article/details/171048817




