Как отформатировать CSV с нужным разделителем и кавычками

Вставьте CSV-текст, выберите его разделитель и символ кавычек, затем задайте режим оформления и запустите обработку. В результате появятся переписанный CSV, количество строк и максимальная ширина строки в полях.

Проверяйте настройки по исходной структуре данных, потому что инструмент сначала разбирает непустой текст, а затем записывает его заново.

Назначение форматтера CSV

CSV Formatter помогает привести текст CSV к выбранным правилам записи: задать разделитель, символ кавычек и режим оформления. Это подходит для подготовки данных к обмену между системами, проверки структуры таблицы перед импортом и получения единообразного вида строк.

Инструмент принимает именно текст CSV. Подготовьте содержимое заранее и учитывайте фактический знак между полями. Если в исходных строках используется точка с запятой, её нужно выбрать вместо запятой, установленной по умолчанию. Такой выбор влияет на то, как строки будут разобраны и затем записаны заново.

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

Перед запуском полезно определить, какой вид записи нужен на выходе. Режим minimal применяет минимальное цитирование CSV, а другое значение режима переводит запись в вариант с кавычками у каждого поля.

Порядок форматирования CSV

Подготовьте CSV-текст без пояснений, которые не относятся к данным. Если нужно проверить пустой ввод, оставьте поле пустым или введите только пробелы: для такого случая отдельный набор параметров не требуется.
Вставьте содержимое в поле CSV. Посмотрите на исходные строки и определите, какой знак отделяет одно поле от другого: например, запятую или точку с запятой. Выберите тот же разделитель в настройках, иначе границы полей могут определиться иначе, чем предполагается.
Укажите символ кавычек. Для данных, где значения оформлены двойными кавычками, оставьте настройку по умолчанию; если исходный текст использует другой выбранный символ, задайте его перед обработкой. Настройки разделителя и кавычек должны соответствовать структуре вставленного текста.
Выберите режим оформления. Значение minimal включает минимальное цитирование CSV. Любое другое значение режима использует заключение каждого поля в кавычки, поэтому для такого результата не требуется искать отдельный вариант с названием «полное цитирование».
Запустите обработку. При непустом вводе без исключения инструмент разбирает строки по выбранным разделителю и символу кавычек, после чего переписывает распознанные строки с теми же настройками. Дождитесь появления результата и просмотрите его начало.
Сопоставьте счётчики с исходными данными. Число строк показывает количество распознанных строк, а число столбцов соответствует самой широкой строке, то есть максимальному числу полей в одной строке. Если вместо текста показан пустой результат, счётчики равны нулю и присутствует описание ошибки, проверьте настройки и структуру CSV, затем повторите обработку.

Проверка полученного результата

Сначала проверьте, правильно ли распознана структура, и только затем оценивайте внешний вид текста. Для двух строк, в каждой из которых находятся три поля, ожидаются два распознанных ряда и ширина в три поля. При более длинной строке показатель столбцов увеличится до её ширины, даже если остальные строки короче.

Режим minimal и режим с другим значением дают разные варианты записи кавычек. В первом случае цитирование остаётся минимальным, а во втором кавычки добавляются к каждому полю. Поэтому размер отформатированного текста может измениться, тогда как число строк и максимальная ширина строки сохранятся при успешной обработке той же структуры.

Полученный текст не следует воспринимать как посимвольную копию исходника. При непустом вводе данные сначала разбираются, а затем записываются заново с заданными параметрами, поэтому пробелы, кавычки и другие элементы оформления могут выглядеть иначе. Сравнивайте прежде всего границы полей и значения счётчиков.

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

Практический пример

Нужно проверить структуру небольшого списка сотрудников перед импортом в систему, которая использует запятую как разделитель.

Вставьте две строки Иван,42,Москва и Ольга,37,Казань, оставьте запятую и двойные кавычки, выберите minimal и запустите обработку, чтобы проверить структуру списка перед импортом в систему с запятым разделителем. Просмотрите текст и показатели в полученном ответе, не ожидая посимвольного совпадения с исходником.

Ответ содержит переписанный CSV, значение строк 2 и значение столбцов 3 при успешной обработке входа из двух строк с тремя полями в каждой строке; режим minimal задаёт минимальное цитирование.

Ограничения

Инструмент формирует CSV заново из распознанных строк, поэтому исходное оформление не сохраняется посимвольно.

Частые ошибки

Если выбрать значение режима, отличное от minimal, а ожидать цитирование только отдельных полей, результат покажется неожиданным: такое значение переводит запись в режим с кавычками у каждого поля. Для минимального варианта укажите именно minimal.

Частые вопросы

Что произойдёт при пустом вводе CSV?

При пустом или состоящем только из пробелов вводе настройка не требуется: обработка завершается успешно, отформатированный текст остаётся пустым, а показатели строк и столбцов равны нулю. Это отдельный результат для такого содержимого.

Как включить цитирование всех полей?

Чтобы получить запись с кавычками у каждого поля, выберите значение режима, отличное от minimal. Само значение minimal предназначено для минимального цитирования CSV, поэтому оно даёт другой вид оформления.

Сохраняется ли исходное оформление CSV посимвольно?

Исходный вид может измениться, поскольку при успешной обработке непустые строки разбираются по выбранным параметрам и формируются заново. Смысл данных оценивайте по границам полей и счётчикам, а не по посимвольному совпадению.