Как заставить PowerShell `Select-String`, также известный как `sls`, выводить только точные совпадения?

Переписывание регулярного выражения может оказаться всем, что вам нужно. Следующее работает для случайной строки с косыми чертами и тире (спасибо mklement0 за указание на упрощение).

^[-/\w]+$

Некоторые объяснения:

• []+ определяет список совпадающих символов, который может повторяться один или несколько раз
• / соответствует косой черте
• - соответствует тире
• \w соответствует символам слова (вы это уже нашли)
• ^ и $ будут соответствовать началу и концу строки (опять же, вы уже это выяснили)

Таким образом, внутренний захват в списке будет соответствовать любому словесному символу, косой черте или тире. Если вы повторите это один или несколько раз и включите начало и конец строки, это будет соответствовать описанному вами шаблону.

Чтобы ответить на ваш общий вопрос:

Меня действительно больше всего интересует, находит ли sls (Select-String) точные совпадения в целом.

• Select-String по дизайну ищет заданный поисковый запрос в виде подстроки в каждой входной строке (строке).^[1]

  • По умолчанию он также сопоставляется без учета регистра, что соответствует обычному регистронезависимому характеру PowerShell; при необходимости используйте переключатель -CaseSensitive.

• По умолчанию каждый поисковый запрос, передаваемый в параметр -Pattern (возможно, позиционно, как первый безымянный аргумент), интерпретируется как регулярное выражение (регулярное выражение).

  • Чтобы искать подстроки буквально (дословно), добавьте переключатель -SimpleMatch.

• Нет возможности запросить совпадение всей строки, поэтому единственный способ добиться соответствия всей строки — это использовать регулярное выражение с привязками ^ и $ .

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

  • Используйте [regex]::Escape(), чтобы выполнить это экранирование программно; в буквальном поисковом запросе вы можете альтернативно \-экранировать метасимволы по отдельности.

• По умолчанию Select-String ищет все совпадения во входном файле/среди входных строк.

  • Чтобы он сообщал только о первом совпадении и прекратил поиск дополнительных, добавьте переключатель -List, но учтите, что это работает только с вводом файла (либо через -Path/-LiteralPath, либо путем передачи объектов информации о файле через Get-ChildItem или Get-Item).

  • Чтобы он сообщал только логическое значение ($true или $false) в зависимости от того, было ли найдено хотя бы одно совпадение (что также прекращает поиск после первого совпадения), вместо этого добавьте переключатель -Quiet.

    • Примечание. При передаче строк в Select-String и совпадении не найдено, начиная с PowerShell 7.4.x, вместо $false неожиданно отсутствует вывод; это следует считать ошибкой — см. выпуск GitHub № 16681.
      Однако приведение этого отсутствия вывода к логическому значению, например в операторе if эквивалентен $false, поэтому эта ошибка обычно не имеет значения.

  • Кроме того, независимо от -List, переключатель -AllMatches требует, чтобы поисковый запрос сопоставлялся так часто, как он встречается в каждой строке (входной строке), а не сообщал только о первом совпадении.

Применительно к вашему случаю:

$existsInLocal = git branch | sls -Quiet ('^\s*{0}$' -f [regex]::Escape($branch))

• Вышеприведенное демонстрирует технику экранирования, хотя в вашем случае это, вероятно, не обязательно, и, согласно вашему отзыву, соответствует \s*, то есть необязательным пробелам перед именем ветки.

• -Quiet делает Select-String вывод $true, если совпадение было найдено (см. выше), а также прекращает поиск в этом случае - это устраняет необходимость в вашем (...) -ne $null тесте, который, кстати, обычно лучше записать как $null -ne (...) - см. соответствующее правило PSScriptAnalzyer

Делаем шаг назад:

Как отмечает Маклейтон , возможно более простое решение для буквального сопоставления целых строк с использованием оператора -contains:

$existsInLocal = (git branch) -contains $branch

• PowerShell автоматически передает выходные данные стандартной программы внешней программы построчно и, заключая вызов в (...) и используя его с оператором, строки собираются в массив (при условии наличия двух или более строк вывода).

• -contains затем выполняет поэлементное сравнение на равенство в этом массиве (по сути, -eq операции с каждым элементом массива в качестве LHS) до тех пор, пока не будет найдено совпадение (не более одного), и в этом случае возвращается $true (в противном случае $false). В данном случае это означает буквальное сравнение целых строк.

  • Примечание. -contains по умолчанию тоже нечувствителен к регистру, но вы можете использовать вариант оператора с учетом регистра -ccontains.

Единственным потенциальным недостатком этого подхода является то, что он требует сбора всех строк стандартного вывода в памяти заранее, прежде чем будет выполнено сопоставление, тогда как потоковая природа конвейерного решения на основе Select-String позволяет остановиться, как только будет найдено совпадение.
Однако при ограниченном объеме вывода стандартного вывода, как в данном случае, это не будет проблемой.

^{[1] The typical use case is that Select-String receives text line by line, such as by making it search a file using -Path / -LiteralPath or when piping the output of an external program to it.
However, when you pass a multiline string as a single object to it (e.g. by piping Get-Content -Raw to it), that string is searched through as a whole, enabling cross-line matching.}