Was ist eine Bug-Bericht-Vorlage?
Eine Bug-Bericht-Vorlage ist ein standardisiertes Formular, das alles erfasst, was ein Entwickler benötigt, um einen Fehler zu verstehen, zu reproduzieren und zu beheben. Anstatt dass jeder Tester Berichte in seinem eigenen Stil verfasst, sorgt eine Vorlage für Konsistenz – dieselben Felder, in derselben Reihenfolge, jedes Mal.
Das Ergebnis ist weniger Hin und Her, schnellere Behebungen und weniger Sackgassen nach dem Motto „bei mir funktioniert es". Ob Sie es Bug-Vorlage, Bug-Tracker-Vorlage oder Fehlerbericht nennen, das Ziel ist identisch: Entwicklern von Anfang an umsetzbare Informationen liefern.
Die Bug-Bericht-Vorlage (Zum Kopieren und Einfügen)
Hier ist eine Bug-Bericht-Vorlage, die Sie direkt in Ihren Issue-Tracker, Ihre E-Mail oder Ihre Dokumentation kopieren können:
Title: [Short, specific summary of the issue]
ID: [BUG-0001]
Reporter: [Your name]
Date: [YYYY-MM-DD]
Priority: [Critical / High / Medium / Low]
Status: [Open]
Environment:
- URL: [https://example.com/checkout]
- Browser: [Chrome 120, macOS 14]
- Device: [Desktop / iPhone 14]
- Resolution: [1920x1080]
- User account: [test@example.com]
Steps to Reproduce:
1. [Go to ...]
2. [Click ...]
3. [Enter ...]
4. [Observe ...]
Expected Result:
[What should have happened]
Actual Result:
[What actually happened]
Screenshot:
[Attach annotated screenshot highlighting the issue]
Screen Recording:
[Attach short screen recording (WebM/MP4) showing the bug in action]
Console Errors / Network Failures:
[Paste any error-level console logs or failed network requests]
Notes:
[Workarounds, frequency (always / intermittent), related tickets]
Beispiele für Bug-Titel
Der Titel ist das wichtigste Feld – Entwickler überfliegen ihn zuerst im Backlog. Ein guter Bug-Titel ist spezifisch, nennt die Komponente und beschreibt den Fehler. Nachfolgend finden Sie Beispiele für Bug-Titel, die den Unterschied zwischen schwachen und starken Titeln zeigen.
Schwache Titel (vermeiden):
- "Button kaputt"
- "Fehler"
- "Es funktioniert nicht"
- "Bug auf der Startseite"
Starke Titel:
- "Checkout-‚Absenden'-Button friert die Seite für 5s ein und zeigt dann einen leeren Bildschirm auf mobilem Safari"
- "Profil-Avatar-Upload gibt 500-Fehler zurück, wenn die Datei 5 MB überschreitet"
- "Datumsauswahl überlappt den ‚Speichern'-Button auf Bildschirmen schmaler als 768px"
- "Newsletter-Anmeldeformular sendet sich beim Drücken der Eingabetaste doppelt"
Ein nützliches Muster ist: [Komponente] + [Aktion] + [Unerwartetes Ergebnis] + [Bedingung]. Zum Beispiel: „Warenkorbzähler aktualisiert sich nicht nach dem Entfernen des letzten Artikels auf Firefox."
Schritte zur Reproduktion eines Bugs: Beispiel
Vage Reproduktionsschritte sind die häufigste Ursache für Tickets mit dem Vermerk „kann nicht reproduziert werden". Hier ist ein gut umgesetztes Beispiel für Schritte zur Reproduktion eines Bugs:
test@example.com an/cartErwartet: Der Warenkorbzähler aktualisiert sich sofort nach dem Entfernen auf „0". Tatsächlich: Der Warenkorbzähler bleibt bei „1", bis die Seite vollständig neu geladen wird.
Der Schlüssel ist, dass jeder – ein Entwickler, ein QA-Ingenieur oder ein Produktmanager – diese genauen Schritte befolgen und dasselbe Ergebnis sehen kann.
Beispiel für einen vollständigen Bug-Bericht
Hier ist ein vollständiges Beispiel für einen Bug-Bericht unter Verwendung der obigen Vorlage, damit Sie sehen können, wie er ausgefüllt aussieht:
Title: Cart counter does not update after removing last item on Firefox
ID: BUG-0042
Reporter: Sarah Chen
Date: 2026-08-05
Priority: Medium
Status: Open
Environment:
- URL: https://shop.example.com/cart
- Browser: Firefox 121, macOS 14
- Device: Desktop
- Resolution: 1440x900
- User account: test@example.com
Steps to Reproduce:
1. Log in as test@example.com
2. Add "Wireless Mouse" to the cart
3. Go to /cart
4. Click "Remove" next to the product
Expected Result:
The header cart counter updates from "1" to "0" instantly.
Actual Result:
The counter stays at "1" until the page is refreshed.
Screenshot:
[Attached: annotated screenshot highlighting the stale counter]
Screen Recording:
[Attached: 12s WebM recording showing the counter stuck after removal]
Console Errors / Network Failures:
None
Notes:
Reproducible 100% on Firefox. Works correctly on Chrome and Safari.
Likely a state-sync issue in the cart event listener.
Bug-Tracker-Vorlage
Wenn Sie Bugs auf Teamebene verwalten, hilft Ihnen eine Bug-Tracker-Vorlage (manchmal auch Bug-Tracking-Vorlage genannt), mehrere Berichte in einer Tabelle zu organisieren. Hier ist eine einfache Struktur:
| ID | Title | Priority | Status | Assignee | Reporter | Date | URL | Recording | Reproducible |
|---|---|---|---|---|---|---|---|---|---|
| BUG-0042 | Cart counter stale on Firefox | Medium | Open | — | Sarah C. | 2026-08-05 | /cart | ✅ | Yes |
| BUG-0043 | Login button unresponsive on iOS 17 | High | In Progress | M. Lee | Tom K. | 2026-08-04 | /login | ✅ | Yes |
| BUG-0044 | PDF export missing page numbers | Low | Open | — | Ana R. | 2026-08-03 | /reports | — | Intermittent |
Sie können dies in Google Sheets, Excel, Notion oder einem anderen Tool erstellen, das Ihr Team bereits verwendet. Wichtig ist, dass jede Spalte einem Feld in der obigen Bug-Bericht-Vorlage entspricht, sodass einzelne Berichte sauber in den Tracker einfließen.
Download: Bug-Bericht-Vorlage (Word & Markdown)
Möchten Sie eine gebrauchsfertige Datei? Sie können den Vorlagenabschnitt oben kopieren in:
- Microsoft Word — einfügen und als
.docxspeichern für ein Word-Dokument mit der Bug-Bericht-Vorlage, das Ihr Team offline ausfüllen kann. - Markdown — den rohen Textblock oben in Ihrem Repository oder Wiki für eine versionierte Bug-Vorlage behalten.
- Issue-Tracker — jedes Feld einem benutzerdefinierten Feld in Jira, Linear, GitHub Issues oder Trello zuordnen.
Dieselbe Vorlage funktioniert über alle Formate hinweg, da sie reiner Text ist – keine proprietäre Formatierung, die kaputtgehen kann.
Wie BugCapturer die Vorlage automatisch ausfüllt
Die meisten Felder in der Bug-Bericht-Vorlage sind mühsam von Hand auszufüllen – und genau dort werden Berichte schlampig. BugCapturer, eine Browsererweiterung für Bug-Meldungen und Web-Feedback, automatisiert die sich wiederholenden Teile:
- Screenshot mit Anmerkungen: Ziehen Sie, um den Problembereich auszuwählen, fügen Sie Pfeile, Rechtecke und Text hinzu, um Probleme hervorzuheben – kein separates Screenshot-Tool erforderlich.
- Bildschirmaufnahme (v1.2.0): Nehmen Sie den aktuellen Tab als WebM-Video auf, schneiden Sie dann den Clip und extrahieren Sie Schlüsselbilder – alles im Browser, ohne Uploads. Fügen Sie die Aufnahme direkt Ihrem Bug-Bericht bei.
- Automatische technische Metadaten: URL, Browser, Betriebssystem, Bildschirmauflösung und Viewport werden automatisch erfasst, sodass der Umgebungsblock sich selbst ausfüllt.
- Diagnosedatenerfassung: Erfasst fehlerhafte Konsolenprotokolle und fehlgeschlagene Netzwerkanfragen (HTTP-Status ≥ 400). Netzwerk-URLs werden automatisch von sensiblen Parametern (Token, Passwörter, API-Schlüssel) bereinigt.
- Excel/TSV-Export (v1.2.0): Mit einem Klick eine 12-spaltige strukturierte Bug-Bericht-Zeile (URL, Metadaten, Konsolenfehler, Netzwerkfehler) in die Zwischenablage kopieren. Direkt in Excel, Google Sheets oder Numbers für teamweites Tracking einfügen.
- E-Mail mit einem Klick: Alles wird in eine strukturierte E-Mail verpackt, die der Vorlage entspricht, und kann direkt an den Entwickler gesendet werden.
Das Ergebnis ist ein Bug-Bericht, der der obigen Vorlage entspricht – ohne manuelle Eingaben.
Checkliste für Bug-Berichte
Bevor Sie Ihren nächsten Bericht einreichen, überprüfen Sie, ob jedes Feld abgedeckt ist:
- Klarer, spezifischer Titel (Komponente + Aktion + Ergebnis + Bedingung)
- Umgebungsdetails (URL, Browser, Betriebssystem, Auflösung)
- Nummerierte Schritte zur Reproduktion
- Erwartetes vs. tatsächliches Ergebnis
- Screenshot mit Anmerkungen oder Aufnahme
- Bildschirmaufnahme (WebM) für schwer zu beschreibende Bugs
- Konsolenfehler / Netzwerkfehler (falls vorhanden)
- Excel/TSV-Export für Team-Tracking (optional, aber empfohlen)
- Priorität und Reproduzierbarkeit notiert
Verwenden Sie diese Vorlage für jeden Bericht, und Ihre Entwickler werden weniger Zeit damit verbringen, zu fragen „Was hast du gemacht?" und mehr Zeit damit, den Bug tatsächlich zu beheben.