CSV и экспорт

Как исправить запятые, кавычки и UTF-8 в CSV

CSV с метаданными может выглядеть нормально в текстовом редакторе, но при открытии в таблице разбить заголовок на несколько ячеек или испортить буквы с диакритикой. Проблема обычно возникает из-за сочетания запятых внутри значений, кавычек внутри названия и неверной кодировки. Например, São Paulo или Łódź сразу показывают, что файл прочитан неправильно. Ниже — рабочий порядок подготовки, проверки и экспорта CSV для стокового процесса.

Три шага проверки CSV: Экранируйте сложные поля — Заключите поля с запятыми в кавычки и удвойте внутренние кавычки.; Проверьте UTF-8 — Откройте CSV с разделителем-запятой и кодировкой UTF-8.; Проверьте импорт — Сверьте имена файлов и каждое значение в кабинете автора.
Схема рабочего процесса из этого руководства.

Сначала определите структуру строки

Строка CSV должна связывать точное имя файла с его title, списком keywords и нужными полями конкретной платформы. Если сервис требует совпадения, имя файла вместе с расширением и регистром должно быть таким же, как у загруженного ассета. Для Adobe Stock сначала загружают файлы, затем импортируют CSV и проверяют результат в кабинете автора.

Не рассчитывайте, что одна схема подойдет всем площадкам. У Adobe, Envato и Shutterstock различаются поля и ограничения, поэтому перед экспортом откройте актуальные требования нужной площадки. Синтаксически правильный CSV все равно может потребовать исправлений или не соответствовать текущему формату импорта.

  • Оставьте одну строку заголовков и одну запись на ассет.
  • Указывайте точное имя файла с расширением и регистром.
  • Отделяйте проверку синтаксиса CSV от проверки требований площадки.

Три правила экранирования

Сохраняйте файл в UTF-8, чтобы буквы вроде ã, ó или ł не превращались в знаки замены. Затем применяйте правила CSV. Поле с запятой заключают в двойные кавычки. Поле с кавычками тоже заключают в двойные кавычки, а каждую внутреннюю кавычку записывают двумя кавычками.

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

  • Запятая внутри значения: заключите все поле в кавычки.
  • Кавычка внутри значения: запишите ее двумя кавычками.
  • Список keywords: заключите в кавычки весь список.
  • Сохраните файл в UTF-8 и проверьте его повторным открытием.
filename,title,keywords
sao-paulo.jpg,"Street sign ""Centro"", São Paulo, Brazil","street sign,Centro,São Paulo,Brazil,urban travel"

Рабочий пример: одна сложная строка

Пример: файл называется sao-paulo.jpg, а нужный title — Street sign "Centro", São Paulo, Brazil. В нем есть и кавычки, и запятая. Поэтому весь title заключается в двойные кавычки, а кавычки вокруг Centro превращаются в удвоенные.

В поле keywords также есть запятые, поэтому в кавычки заключен весь список. São Paulo сохраняется как текст UTF-8. Описывайте только проверяемое: в примере указаны видимая надпись и подтвержденное название места, без догадок о личности, владельце или деталях, которых нет в кадре.

  • Начните с точного имени sao-paulo.jpg.
  • Замените кавычки вокруг Centro на ""Centro"" внутри CSV.
  • Заключите весь список keywords в кавычки.
  • Используйте релевантные слова и проверьте актуальный лимит площадки.
filename,title,keywords
sao-paulo.jpg,"Street sign ""Centro"", São Paulo, Brazil","street sign,Centro,São Paulo,Brazil,urban travel"

Проверьте файл в таблице

Открывайте копию CSV через диалог импорта текста или CSV, если ваша таблица его предлагает. Выберите разделитель-запятую и кодировку UTF-8. В предварительном просмотре должно быть три столбца: filename, весь title в одной ячейке и весь список keywords в одной ячейке. Если title распался на дополнительные столбцы, запятая не была защищена кавычками либо выбран неправильный разделитель.

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

  • Убедитесь, что разделитель — запятая.
  • Убедитесь, что кодировка — UTF-8.
  • Проверьте ожидаемые столбцы в строке примера.
  • После сохранения повторно откройте CSV.

Генерируйте и редактируйте метаданные локально

MetaStocker умеет генерировать редактируемые метаданные локально в браузере и экспортировать форматы, включая Adobe CSV. В локальном режиме модель работает на устройстве пользователя через WebGPU; для первой загрузки модели нужен интернет. Загрузка модели в память отличается от хранения скачанных файлов в кэше браузера, а сохранение кэша не означает гарантированную постоянную работу офлайн.

Независимо от способа создания строки проверьте каждый title и keywords перед экспортом. Проверка запрошенного количества тегов подтверждает количество, но не фактическую точность и не пригодность CSV. Если используете общее описание для партии, пишите только факты, относящиеся ко всем файлам; индивидуальные детали добавляйте после проверки каждого результата.

  • Отредактируйте сгенерированный title перед экспортом.
  • Сверьте title с актуальным лимитом площадки.
  • Проверьте релевантность, порядок, написание и язык keywords.
  • Экспортируйте только готовые строки.

Проведите финальную проверку импорта

Перед импортом сравните каждое имя в CSV со списком загруженных ассетов, включая расширение и регистр. Убедитесь, что столбцы не сдвинулись, диакритические знаки не изменились, а в поля не попали лишние разделители или переносы строк. Для Adobe Stock используйте консервативный максимум 49 keywords и проверьте текущий экран загрузки, поскольку требования могут меняться.

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

  • Сверьте имена CSV с загруженными файлами.
  • Проверьте язык, требуемый аккаунтом и площадкой.
  • Уточните актуальные лимиты полей и keywords.
  • Проверьте импортированные значения в кабинете автора.

Перед следующим шагом

  • Сохраните CSV в UTF-8.
  • Заключите в кавычки каждое поле с запятой.
  • Удваивайте внутренние двойные кавычки.
  • Храните список keywords в одном поле в кавычках.
  • Проверьте файл с разделителем-запятой и UTF-8.
  • Сверьте имена файлов, расширения и регистр.
  • Проверьте метаданные после импорта на площадке.

Источники и редакционный подход

Материал подготовлен с помощью AI. Примеры в тексте учебные. Автоматические проверки не заменяют проверки требований вашего стока. Как мы готовим материалы.