Tutto ciò che fa, tutto ciò che puoi configurare

Quando i test li ha scritti unʼIA

La copertura contro una suite di test generata

La panoramica espone l'argomento generale. Eccolo applicato all'elenco delle funzionalità stesso, perché una suite generata fallisce in una forma caratteristica — ogni riga toccata, metà delle decisioni mai prese e qualche funzione nominata nei titoli dei test ma mai chiamata davvero — e cinque delle voci qui sotto sono ciò che rende visibile quella forma.

• La copertura di rami e MC/DC, con il tooltip per ciascun arco e ciascuna decisione, separa la riga è stata eseguita da la decisione è stata esercitata. Una suite che percorre solo il percorso felice segna quasi il 100% sulle righe e quasi il 50% sui rami, e proprio quello scarto è il risultato. Un'esecuzione di test tutta verde non ne mostra nulla.
• Il punteggio composito è una media armonica, così una metrica forte non può mascherarne una debole — esattamente l'aritmetica che serve a una suite generata. Fare la media del numero delle righe con quello dei rami seppellirebbe l'unico numero che vale la pena guardare.
• Gli avvisi di codice morto creano una voce nel pannello Problems per ogni funzione con righe misurabili e copertura zero. Una suite che nomina una funzione nel titolo di un test e non la raggiunge mai non fallisce da nessun'altra parte.
• La copertura del diff rispetto a un ref di base git restringe tutto quanto sopra alle righe appena cambiate — il codice che hai accettato questo pomeriggio, anziché la media di tutta la vita del repository, con cui una grande suite già esistente continuerà allegramente a sembrare in salute.
• Copy Uncovered Lines emette esattamente ciò che non è mai stato eseguito, in Markdown — cioè qualcosa da incollare dritto all'assistente che quella suite l'ha scritta in origine.

Niente di tutto questo legge un test e lo giudica, e nulla qui va inteso come una simile pretesa: un test senza alcuna asserzione copre comunque ogni riga che tocca. Ciò che si misura è la parte che un revisore non riesce a tenere a mente — quale codice non è mai stato eseguito.

Unico per questa estensione

La vostra coverage delle righe dice 100%. 312 byte del vostro binario non sono mai stati eseguiti.

Ogni altra metrica qui si misura dal sorgente: instrumentare il codice, eseguire la build instrumentata, contare cosa è scattato. La coverage del codice oggetto misura qualcosa che nessuno strumento basato sul sorgente può raggiungere — quanta parte del binario costruito è stata davvero eseguita, in byte di istruzioni, osservando il flusso di istruzioni. Un compilatore produce codice di cui nessuna riga del vostro sorgente rende conto: controlli sui limiti degli array, tabelle di salto di switch, salvataggi di registri, routine di runtime per divisione o virgola mobile. Nulla di tutto ciò appare nel vostro sorgente, quindi nessuno strumento basato sul sorgente — inclusa questa estensione, per qualsiasi altra metrica che legge — può dire se sia stato eseguito. È anche l'unica metrica qui che risponde a questo copre l'assembly?, dato che l'assembly scritto a mano non viene mai instrumentato.

DO-178C lo nomina esplicitamente: al livello A è richiesto in aggiunta a MC/DC. Nessun'altra estensione di VS Code lo legge. Come ottenerlo da un target embedded →

Capacità

Funzionalità principali

• Una vista Coverage di ogni file misurato, il righello di panoramica e Annotated Source; nel gutter dell'editor stesso, per impostazione predefinita, solo ciò che merita un segno — barre MC/DC, triangoli «dall'ultima esecuzione», puntini sulle righe modificate — con barre solo sulle righe non coperte o una mappa di calore dei conteggi a un'impostazione di distanza.
• Copertura per riga di istruzioni, rami, funzioni, regioni, MC/DC e istanziazioni C++, a seconda di ciò che fornisce il file di traccia.
• Importazione multi-formato e unione deterministica di più esecuzioni con provenienza registrata.
• Rimappatura dei percorsi — percorsi della macchina di build CI → il tuo spazio di lavoro locale.
• Coverage differenziale — decora solo le righe modificate rispetto a un riferimento base git.
• Badge Explorer e un elemento della barra di stato a livello di esecuzione, colorato in base al punteggio composito.
• Modalità watch — ricaricamento automatico quando un file di traccia cambia.
• Run Tests with Coverage — riconosce il test runner dalla radice dello spazio di lavoro e lo esegue con la copertura attiva, caricando ciò che scrive.
• Tracefile remoti — una voce di coverageFile.paths può essere un URL https://: l'artefatto CI viene scaricato in modo condizionale (ETag / Last-Modified), con le intestazioni configurate in remote.headers, caricato come un file locale e riscaricato a intervalli con remote.refreshMinutes; quando uno scaricamento fallisce, viene caricata l'ultima copia scaricata.
• Variabili nei percorsi — ${workspaceFolder}, ${workspaceFolderBasename}, ${userHome}, ${env:NAME}, ${command:id} e ${config:section.key} in ogni impostazione di percorso; una variabile sconosciuta viene lasciata com'è scritta, così un errore di battitura compare nel log di rilevamento anziché sparire.
• Spazi di lavoro multi-root — ogni cartella viene rilevata dalle proprie impostazioni (il suo .vscode/settings.json o la sua voce nel .code-workspace), i suoi tracefile si uniscono in un'unica esecuzione, la vista Coverage raggruppa i file per cartella, e una cartella aggiunta o rimossa ricarica la copertura da sola.
• Due trigger di ricaricamento in più — una voce assoluta di coverageFile.paths fuori dallo spazio di lavoro viene sondata, così un file che compare lì viene caricato; e watch.reloadAfterTasks nomina attività (npm: test) la cui fine ricarica la copertura, che la modalità watch sia attiva o no.
• Avanzamento annullabile — un caricamento di dieci o più tracefile, o di 8 MB o più, e ogni Generate Full HTML Report girano sotto una notifica di avanzamento con un pulsante Annulla; annullare lascia caricata l'esecuzione precedente.
• La vista Test Coverage di VS Code stesso — ogni caricamento viene pubblicato anche tramite l'API Test Coverage dell'editor (testCoverage.publish), così il pannello di copertura del Test Explorer, le percentuali per file dell'Explorer e l'interruttore Show Inline Coverage dell'editor mostrano gli stessi numeri; Show in Test Coverage View pubblica su richiesta e apre il pannello. Con test con nome (TN: in lcov), la vista filtra la copertura di un file per test.
• Regola di rimappatura suggerita — quando un caricamento lascia file senza corrispondenza (percorsi di container o CI contro un checkout locale), l'estensione deduce la regola pathRemap che ne spiega il maggior numero, offre Apply Suggested Remap sul risultato del caricamento e Suggest Path Remap Rule nella palette; nulla viene scritto senza il clic.
• Glob di esclusione — fuciniCoverage.ignore (vendor/**, **/*.generated.ts) esclude file interi dall'esecuzione al caricamento, così ogni vista, gate ed esportazione conta senza di essi; il risultato del caricamento dice quanti e l'output nomina ciascuno.
• Non misurato contro non coperto — un file che nessun test ha caricato non viene valutato 0% alle tue spalle; la barra di stato dice not measured per uno di essi, e unmeasured.mode può elencare tali file nella vista Coverage o contare ciascuno come file non coperto, con threshold.unmeasuredFiles per fare gate su quanti ce ne sono.
• Cosa ha fatto la fusione, visibile — con più tracefile caricati, ogni riga di file nomina il report da cui vengono i suoi numeri, il badge ha un contorno dove quei numeri hanno prevalso su un report più vecchio, ogni riga di tracefile conta quanti dei suoi file sono stati sostituiti o ne hanno sostituiti altri, e un clic su una riga di tracefile evidenzia i suoi file nell’albero (coverageView.mergedMarks).

Punteggio composito e conformità

Una singola media armonica ponderata su righe, rami, funzioni, regioni, MC/DC e istanziazioni. Essendo una media armonica, una metrica debole non può essere mascherata da una perfetta. I pesi sono allineati per impostazione predefinita ai livelli IEC 61508 / ISO 26262 / DO-178C, e il verdetto COMPLIANT / NON-COMPLIANT è determinato da soglie per metrica più una modalità configurabile.

Screenshot pending — add assets/img/statusbar.png (see SCREENSHOTS.md).

Analisi nell'editor

• CodeLens di funzione — % di copertura per funzione, clicca per saltare alla prima riga non coperta.
• Hover su ramo e MC/DC — conteggi presi/non presi per ramo e dettagli condizione/vettore per decisione; indicatore di margine MC/DC colorato opzionale.
• Avvisi di codice morto — avviso nel pannello Problems per funzioni con righe misurabili e copertura pari a zero.
• Navigazione Next/Previous Uncovered.
• Avviso di discrepanza quando il contenuto di un file non si adatta più alla sua esecuzione — aggiornato al salvataggio o alla modifica su disco, con la differenza esatta al passaggio del mouse.
• Dall'ultima esecuzione — un triangolo rosso su ogni riga eseguita nell'esecuzione precedente e non in questa, uno verde per il caso inverso, con il righello panoramico e i conteggi al passaggio del mouse.
• Buffer modificati — ogni contrassegno, suggerimento e CodeLens si sposta con il testo mentre modifichi, e si ritira da una riga riscritta, dove un punto grigio dice perché.
• Modalità del gutter dell'editor — editorGutter.mode limita il gutter ai rilievi (off), mette una barra su ogni riga mai eseguita e una ambra dove un arco di ramo non è mai stato preso (uncovered), oppure aggiunge una tinta calda su ogni riga eseguita, più intensa quanto più spesso è stata eseguita (heatmap); Choose Editor Gutter Mode... cambia modalità dalla palette o dal menu della barra di stato.
• Conteggi dei colpi in linea — hitCounts.inline scrive ×12 dopo ogni riga su cui inizia un'istruzione, ×0 compreso; Toggle Inline Hit Counts lo alterna.
• Voci per riga nel pannello Problems — problems.perLine mette una diagnostica di tipo Information su ogni blocco di righe mai eseguite in un documento aperto (una funzione morta è una voce, non quaranta) e, facoltativamente, su ogni riga con un arco di ramo mai preso; le voci seguono le loro righe mentre modifichi.
• Tinta di riga e mappa nella barra di scorrimento — lineHighlight mette una tinta traslucida dietro le righe stesse anziché (o oltre a) un segno nel margine, e overviewRuler decide da solo la striscia nella barra di scorrimento: con il margine disattivato è una mappa dei vuoti del file e nulla accanto al codice.
• Quale tracefile ha coperto questa riga — con più report uniti, il suggerimento con il conteggio dei passaggi nomina ognuno che ha coperto la riga (compreso il nome della suite dal TN: di lcov), e un clic su una riga di tracefile nella vista Coverage illumina le righe che ha contribuito.

• Rosso, ambra e verde — la modalità coverage di editorGutter.mode e lineHighlight colora ogni riga misurata con i colori della scala cromatica; il pulsante della modalità nella barra di stato e Alt+G passano da una modalità alla successiva.
• I tuoi colori, in anteprima — la scala cromatica e le tinte della heatmap (heatmap.colors, heatmap.colorsDark) sono impostazioni, e la pagina delle impostazioni le mostra in anteprima su un editor chiaro e su uno scuro mentre vengono scelte.
• Da quale report viene un file — con due report che misurano lo stesso codice, le regole di coverageFile.sources, o Choose Coverage Source for This File..., decidono quale mostra ciascun file invece di far vincere il più recente.

Report e cronologia

• Generate Full HTML Report — un report auto-generato, multi-pagina, per directory; Open Annotated Source per un singolo file.
• Cronologia locale opzionale delle esecuzioni con una tendenza di coverage (▲/▼), oltre a Compare Two History Runs e Compare with Last Run.
• Show Worst-Covered Files / Functions e Copy Uncovered Lines (Markdown).
• Export Fucini JSON — il modello normalizzato completo.
• Export Coverage Report... — la stessa esecuzione come CSV (per file o per funzione), riepilogo Markdown, file di trace LCOV, XML Cobertura, SARIF, o badge SVG autonomo. Con venticinque lettori e questi scrittori l'estensione converte tra formati: caricate JaCoCo o llvm-cov JSON ed emettete l'LCOV che leggono Codecov, Coveralls e SonarQube, o l'XML Cobertura che acquisiscono Jenkins, GitLab e Azure DevOps.
• Generate Coverage Badge — un SVG in stile shields scritto direttamente nello spazio di lavoro (badge.outputPath, predefinito coverage-badge.svg), che un README incorpora con ![coverage](coverage-badge.svg) e nessun servizio in hosting; badge.metric sceglie righe, rami, MC/DC o il punteggio composito, il colore segue i livelli di colorScale.*, e badge.autoUpdate lo riscrive dopo ogni caricamento.

Screenshot pending — add assets/img/report.png (see SCREENSHOTS.md).

Screenshot pending — add assets/img/annotated-source.png (see SCREENSHOTS.md).

Community e Pro, funzione per funzione

Due schede, una sola base di codice. Community è il livello gratuito per sempre, e quello su cui la scheda Pro si posa dopo la prova di 14 giorni; Pro e la prova sono tutto, senza limiti. La linea è tracciata perché il livello gratuito veda sempre ogni rilievo e paghi solo comodità, prova e scala — in VS Code, Fucini Coverage: What Community Includes mostra lo stesso elenco con i conteggi di oggi per ogni limite.

Una settimana dura sette giorni dal primo utilizzo che l'ha aperta, e nulla di ciò che si limita a leggere la copertura viene conteggiato. Non sei pronto per un abbonamento? Un pass di 7 giorni è tutto ciò che trovi nella colonna di destra per una settimana, pagato una volta sola, senza niente da disdire.

VS Code e Visual Studio a confronto

Un prodotto, due editor, un lettore: lo stesso report dà gli stessi numeri, alla cifra, in entrambi. Coverage Studio per Visual Studio funziona su Visual Studio 2022 e 2026 — Community, Professional ed Enterprise e non usa la code coverage propria di Visual Studio, che nel 2022 è solo per Enterprise; è incluso in ogni piano a pagamento, e un dispositivo con entrambi gli editor è un posto. Tutto ciò che sta sopra la linea è in entrambi; sotto, ciò per cui Visual Studio non ha un equivalente e ciò che lì deve ancora arrivare.

Riferimento impostazioni

Configura nell'interfaccia delle impostazioni (cerca Fucini Coverage) o in settings.json.

Download the complete settings reference — a commented settings.json holding every fuciniCoverage.* setting at the same default the packaged extension uses, ready to copy into your workspace or user settings. Regenerated from the extension on every release, so it cannot drift from what the VSIX ships.

Una riga che termina con Per cartella. accetta un valore a livello di cartella in uno spazio di lavoro multi-root: ogni cartella viene rilevata con il proprio .vscode/settings.json o con la propria voce nel .code-workspace, e ${workspaceFolder} al suo interno indica quella cartella.

Localizzazione

Rilevamento e caricamento

Scala di colori e badge

Punteggio composito (media armonica ponderata)

Soglie e conformità

Diff, rimappatura e report

Visualizzazione e analisi

Cronologia

Azioni rapide della barra di stato

Tutte impostate su false per impostazione predefinita tranne le ultime due; abilita per aggiungere l'azione corrispondente al menu rapido: quickActions.compareWithLastRun, openAnnotatedSource, openAnnotatedSourceToSide, toggleAnnotatedSource, toggleWatch, worstCoveredFiles, worstCoveredFolders, worstCoveredFunctions, nextUncovered, previousUncovered, checkThresholds, copyUncoveredLines, compareHistoryRuns, exportJson, exportReport, generateBadge, showTestCoverage, chooseGutterMode, toggleInlineHitCounts.

Telemetria

Aggiornamenti

Licenze