Всё, что он умеет, всё, что вы можете настроить

Когда тесты написал ИИ

Покрытие против сгенерированного набора тестов

Обзор излагает общий аргумент. Здесь тот же аргумент приложен к самому списку возможностей: сгенерированный набор тестов ошибается характерным образом — каждая строка задета, половина решений так и не принята, а несколько функций названы в заголовках тестов, но ни разу не вызваны, — и пять пунктов ниже как раз и делают эту форму видимой.

• Покрытие ветвей и MC/DC вместе с подсказкой по каждой ветви и каждому решению отделяют строка выполнилась от решение было проверено. Набор тестов, идущий только счастливым путём, показывает почти 100% по строкам и около 50% по ветвям — и именно этот разрыв и есть находка. Зелёный прогон тестов не показывает из него ничего.
• Составной балл — это гармоническое среднее, поэтому сильная метрика не может прикрыть слабую; ровно такая арифметика и нужна сгенерированному набору тестов. Усреднение числа по строкам с числом по ветвям похоронило бы единственное число, на которое стоит смотреть.
• Предупреждения о мёртвом коде заводят запись в панели Problems для любой функции с измеримыми строками и нулевым покрытием. Набор тестов, который называет функцию в заголовке теста и никогда до неё не доходит, больше нигде не упадёт.
• Diff-покрытие относительно базового git-рефа сужает всё вышесказанное до строк, которые только что изменились, — до кода, который вы приняли сегодня днём, а не до среднего за всю жизнь репозитория, с которым большой существующий набор тестов будет и дальше преспокойно выглядеть здоровым.
• Copy Uncovered Lines выдаёт ровно то, что не выполнялось, в Markdown — то есть то, что вставляется прямо обратно тому ассистенту, который этот набор тестов и написал.

Ничто из этого не читает тест и не выносит о нём суждения, и ничего здесь не следует понимать как такое заявление: тест вообще без единой проверки всё равно покрывает каждую строку, которой касается. Измеряется та часть, которую ревьюер не удержит в голове, — какой код никогда не выполнялся.

Уникально для этого расширения

Ваше покрытие строк говорит 100%. 312 байт вашего двоичного файла ни разу не выполнились.

Все остальные метрики здесь измеряются по исходнику: инструментируйте код, запустите инструментированную сборку, посчитайте, что сработало. Покрытие объектного кода измеряет то, до чего не доберётся ни одно средство уровня исходного кода — сколько собранного двоичного файла действительно выполнилось, в байтах инструкций, за счёт наблюдения за потоком инструкций. Компилятор порождает код, за которым не стоит ни одна строка вашего исходника: проверки границ массивов, таблицы переходов switch, выгрузка регистров, вспомогательные подпрограммы среды выполнения для деления или плавающей точки. Ничего из этого не появляется в вашем исходнике, поэтому ни одно средство уровня исходного кода — включая это расширение, для любой другой читаемой им метрики — не скажет, выполнилось ли это. Это также единственная здесь метрика, отвечающая на вопрос покрывает ли это ассемблер?, поскольку написанный вручную ассемблер никогда не инструментируется.

DO-178C прямо называет это: на уровне A это требуется в дополнение к MC/DC. Ни одно другое расширение VS Code это не читает. Как получить это со встраиваемой цели →

Возможности

Основное

• Представление «Покрытие» для каждого измеренного файла, обзорная линейка и Annotated Source; в собственном поле редактора по умолчанию — только то, что заслуживает отметки: полосы MC/DC, треугольники «с последнего прогона», точки изменённых строк, — а полосы только на непокрытых строках или тепловая карта попаданий включаются одной настройкой.
• Построчное покрытие операторов, ветвей, функций, регионов, MC/DC и инстанциаций C++, в зависимости от того, что предоставляет файл трассировки.
• Приём нескольких форматов и детерминированное объединение нескольких прогонов с зафиксированным происхождением.
• Переотображение путей — пути сборочной машины CI → ваше локальное рабочее пространство.
• Дифференциальное покрытие — оформляет только строки, изменённые относительно базовой ветки git.
• Значки Explorer и элемент строки состояния для всего прогона, окрашенный в соответствии с комплексной оценкой.
• Режим наблюдения — автоматическая перезагрузка при изменении файла трассировки.
• Run Tests with Coverage — распознаёт тестовый раннер по корню рабочего пространства и запускает его с включённым покрытием, загружая записанное.
• Удалённые файлы трассировки — запись coverageFile.paths может быть URL https://: артефакт CI скачивается условно (ETag / Last-Modified), с заголовками, которые вы настроили в remote.headers, загружается как локальный файл и скачивается заново по таймеру через remote.refreshMinutes; когда скачивание не удаётся, вместо него загружается последняя скачанная копия.
• Переменные в путях — ${workspaceFolder}, ${workspaceFolderBasename}, ${userHome}, ${env:NAME}, ${command:id} и ${config:section.key} в каждой настройке путей; неизвестная переменная остаётся как записана, так что опечатка появляется в журнале обнаружения, а не исчезает бесследно.
• Многокорневые рабочие области — каждая папка обнаруживается из собственных настроек (её .vscode/settings.json или её записи в .code-workspace), её файлы трассировки сливаются в один прогон, представление «Покрытие» группирует файлы по папкам, а добавленная или удалённая папка сама перезагружает покрытие.
• Ещё два повода для перезагрузки — абсолютная запись coverageFile.paths вне рабочей области опрашивается, так что появившийся там файл загружается; а watch.reloadAfterTasks называет задачи (npm: test), завершение которых перезагружает покрытие, независимо от того, включён ли режим наблюдения.
• Ход выполнения с возможностью отмены — загрузка десяти и более файлов трассировки, или 8 МБ и более, и каждый Generate Full HTML Report идут под уведомлением о ходе выполнения с кнопкой «Отмена»; отмена оставляет предыдущий прогон загруженным.
• Собственное представление Test Coverage VS Code — каждая загрузка публикуется и через Test Coverage API редактора (testCoverage.publish), так что панель покрытия в Test Explorer, проценты по файлам в Проводнике и переключатель редактора Show Inline Coverage показывают те же числа; Show in Test Coverage View публикует по запросу и открывает панель. Если тесты названы (TN: в lcov), представление фильтрует покрытие файла по тесту.
• Предлагаемое правило переотображения — когда после загрузки остаются несопоставленные файлы (пути контейнера или CI против локального чекаута), расширение выводит правило pathRemap, объясняющее большинство из них, предлагает Apply Suggested Remap в результате загрузки и Suggest Path Remap Rule в палитре; без щелчка ничего не записывается.
• Glob-шаблоны исключения — fuciniCoverage.ignore (vendor/**, **/*.generated.ts) отбрасывает целые файлы из прогона при загрузке, так что каждое представление, каждый барьер и каждый экспорт считают без них; результат загрузки говорит сколько, а вывод называет каждый.
• Неизмеренное против непокрытого — файл, который не загружал ни один тест, не засчитывается как 0% у вас за спиной; строка состояния говорит о нём не измерено, а unmeasured.mode может перечислять такие файлы в представлении «Покрытие» или считать каждый непокрытым файлом, с threshold.unmeasuredFiles как порогом на их число.
• Видно, что сделало слияние — при нескольких загруженных файлах трассировки каждая строка файла называет отчёт, из которого взяты её числа, значок обведён там, где эти числа перекрыли более старый отчёт, каждая строка файла трассировки считает, сколько её файлов перекрыто или перекрыло другие, а щелчок по строке файла трассировки подсвечивает её файлы в дереве (coverageView.mergedMarks).

Комплексная оценка и соответствие

Единое взвешенное среднее гармоническое по строкам, ветвям, функциям, регионам, MC/DC и инстанциациям. Поскольку это среднее гармоническое, слабая метрика не может быть замаскирована идеальной. Веса по умолчанию соответствуют уровням IEC 61508 / ISO 26262 / DO-178C, а вердикт COMPLIANT / NON-COMPLIANT определяется порогами для каждой метрики и настраиваемым режимом.

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

Анализ в редакторе

• CodeLens функции — % покрытия для каждой функции, нажмите, чтобы перейти к её первой непокрытой строке.
• Наведение на ветвь и MC/DC — количество пройденных/непройденных ветвей и разбивка условие/вектор для каждого решения; опциональный цветной индикатор поля MC/DC.
• Предупреждения о мёртвом коде — предупреждение на панели Problems для функций с измеримыми строками и нулевым покрытием.
• Навигация Next/Previous Uncovered.
• Предупреждение о несоответствии, когда содержимое файла больше не соответствует прогону — обновляется при сохранении или изменении файлов на диске, с точной разницей при наведении.
• С последнего прогона — красный треугольник на каждой строке, выполненной в предыдущем прогоне и не выполненной в этом, зелёный для обратного случая, с обзорной линейкой и числом попаданий при наведении.
• Изменённые буферы — каждая отметка, подсказка и CodeLens движутся вместе с текстом при редактировании и снимаются с переписанной строки, где серая точка объясняет почему.
• Режимы поля редактора — editorGutter.mode оставляет полю только находки (off), ставит полосу на каждую строку, которая ни разу не выполнялась, и янтарную там, где одна из ветвей ни разу не была пройдена (uncovered), либо добавляет тёплый оттенок на каждую выполненную строку — тем горячее, чем чаще она выполнялась (heatmap); Choose Editor Gutter Mode... переключает из палитры или меню строки состояния.
• Встроенные числа попаданий — hitCounts.inline пишет ×12 после каждой строки, на которой начинается оператор, включая ×0; Toggle Inline Hit Counts переключает это.
• Записи в Problems на каждую строку — problems.perLine ставит диагностику уровня Information на каждый блок строк, которые ни разу не выполнялись в открытом документе (мёртвая функция — одна запись, а не сорок), и по желанию на каждую строку, где одна из ветвей ни разу не была пройдена; записи следуют за своими строками при правке.
• Подсветка строки и карта на полосе прокрутки — lineHighlight кладёт полупрозрачный фон за сами строки вместо (или вдобавок к) метки в поле, а overviewRuler сам решает насчёт полосы на полосе прокрутки: при выключенном поле это карта пробелов файла и ничего рядом с кодом.
• Какой файл трассировки покрыл эту строку — когда объединено несколько отчётов, подсказка со счётчиком выполнений называет каждый, покрывший строку (включая имя набора из TN: в lcov), а щелчок по строке файла трассировки в представлении Coverage подсвечивает внесённые им строки.

• Красный, янтарный и зелёный — режим coverage у editorGutter.mode и lineHighlight окрашивает каждую измеренную строку цветами цветовой шкалы; кнопка режима в строке состояния и Alt+G переходят от одного режима к следующему.
• Ваши цвета, с предпросмотром — цветовая шкала и оттенки тепловой карты (heatmap.colors, heatmap.colorsDark) — это настройки, и страница настроек показывает их на светлом и тёмном редакторе прямо во время выбора.
• Из какого отчёта берётся файл — когда два отчёта измеряют один и тот же код, правила coverageFile.sources или Choose Coverage Source for This File... решают, какой из них показывает каждый файл, вместо того чтобы побеждал самый новый.

Отчётность и история

• Generate Full HTML Report — самостоятельно формируемый, многостраничный отчёт по каждому каталогу; Open Annotated Source для одного файла.
• Опциональная локальная история прогонов с трендом покрытия (▲/▼), а также Compare Two History Runs и Compare with Last Run.
• Show Worst-Covered Files / Functions и Copy Uncovered Lines (Markdown).
• Export Fucini JSON — полная нормализованная модель.
• Export Coverage Report... — тот же запуск как CSV (по файлам или по функциям), сводка в Markdown, файл трассировки LCOV, XML Cobertura, SARIF или автономный значок SVG. С двадцатью пятью читателями и этими записями расширение конвертирует между форматами: загрузите JaCoCo или llvm-cov JSON и выдайте LCOV, который читают Codecov, Coveralls и SonarQube, или XML Cobertura, который читают Jenkins, GitLab и Azure DevOps.
• Generate Coverage Badge — SVG в стиле shields, записанный прямо в рабочую область (badge.outputPath, по умолчанию coverage-badge.svg), чтобы README встраивал его через ![coverage](coverage-badge.svg) без размещённого сервиса; badge.metric выбирает строки, ветви, MC/DC или комплексную оценку, цвет следует уровням colorScale.*, а badge.autoUpdate перезаписывает его после каждой загрузки.

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

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

Community и Pro, функция за функцией

Два листинга, одна кодовая база. Community — навсегда бесплатный уровень, и именно на него переходит листинг Pro после 14-дневного пробного периода; Pro и пробный период — это всё, без ограничений. Граница проведена так, чтобы бесплатный уровень всегда видел каждую находку и платил лишь за удобство, доказательство и масштаб — в VS Code команда Fucini Coverage: What Community Includes показывает тот же список с сегодняшними счётчиками по каждому лимиту.

Неделя длится семь дней с первого использования, которое её открыло, и ничто из того, что только читает покрытие, не учитывается. Не готовы к подписке? Пропуск на 7 дней — это всё из правой колонки на одну неделю, с разовой оплатой, и отменять ничего не нужно.

VS Code и Visual Studio бок о бок

Один продукт, два редактора, один читатель: один и тот же отчёт даёт одни и те же числа, до цифры, в обоих. Coverage Studio для Visual Studio работает в Visual Studio 2022 и 2026 — Community, Professional и Enterprise и не использует собственное покрытие кода Visual Studio, которое в 2022 есть только в Enterprise; он включён в каждый платный план, а устройство с обоими редакторами — это одно место. Всё над чертой есть в обоих; под ней — то, чему в Visual Studio нет аналога, и то, что там ещё впереди.

Справочник настроек

Настройте в интерфейсе настроек (поиск Fucini Coverage) или в 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.

Строка, заканчивающаяся на По папкам., принимает значение уровня папки в многокорневой рабочей области: каждая папка обнаруживается со своим .vscode/settings.json или своей записью в .code-workspace, и ${workspaceFolder} в ней означает эту папку.

Локализация

Обнаружение и загрузка

Цветовая шкала и значки

Комплексная оценка (взвешенное среднее гармоническое)

Пороги и соответствие

Diff, переотображение и отчёты

Отображение и анализ

История

Быстрые действия строки состояния

Все по умолчанию false, кроме двух последних; включите, чтобы добавить соответствующее действие в быстрое меню: quickActions.compareWithLastRun, openAnnotatedSource, openAnnotatedSourceToSide, toggleAnnotatedSource, toggleWatch, worstCoveredFiles, worstCoveredFolders, worstCoveredFunctions, nextUncovered, previousUncovered, checkThresholds, copyUncoveredLines, compareHistoryRuns, exportJson, exportReport, generateBadge, showTestCoverage, chooseGutterMode, toggleInlineHitCounts.

Телеметрия

Обновления

Лицензирование