Toolion2026头像
纯前端实现的 .gitignore 生成器技术实现封面图

纯前端实现的 .gitignore 生成器技术实现

关键词:.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

文章来源转载

评论

评论列表

微信小程序
QQ小程序

关于作者

点赞数:0
关注数:0
粉丝:0
文章:0
关注标签:0
加入于:--