Имена файлов на Windows и Mac: что ломается из-за кириллицы и спецсимволов

Что запрещает Windows

По документации Microsoft, в имени файла допустимы любые символы текущей кодовой страницы, включая Unicode, кроме перечисленных ниже:

• зарезервированные символы: < > : " / \ | ? *;
• символы с кодами от 0 до 31;
• зарезервированные имена устройств: CON, PRN, AUX, NUL, COM1–COM9, LPT1–LPT9; их нельзя использовать и с расширением, например NUL.txt;
• нельзя заканчивать имя пробелом или точкой.

Регистр и длина пути

Документация предупреждает: не стоит считать имена чувствительными к регистру — OSCAR, Oscar и oscar в Windows считаются одним именем, хотя в других файловых системах это три разных файла. Для путей в версиях Windows до 10 (1607) действует ограничение MAX_PATH в 260 символов; в новых версиях его можно снять настройкой.

Особенность macOS: «й» из двух символов

На macOS имена файлов могут храниться в разложенной форме Unicode (NFD): буква «й» превращается в «и» плюс отдельный знак краткой. В файловой системе HFS+ имена приводятся к такой форме при записи. APFS сохраняет ту форму, в которой имя передано, но при поиске считает варианты одинаковыми. Если же файл создан в обход системных функций (например, из терминала), форма может остаться любой. Git при этом иногда видит два файла, различающихся только формой записи.

На практике это означает, что файл «Договор.pdf» с буквой «й» на одной системе может не найтись по имени, введённому на другой.

Что делать с файлами для сайта

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

Расширение добавляйте после преобразования. Подробнее про документы — в статье «Имена файлов PDF и документов», про картинки — в статье «Изображения в статьях».

Источники

Использованы документация Microsoft об именах файлов и материалы Eclectic Light о нормализации имён в APFS.

Типичные ошибки

• Использовать в имени символы : ? * " < > |.
• Называть файл nul, con, aux.
• Оставлять точку или пробел в конце имени.
• Рассчитывать на различие имён по регистру: на Windows оно не работает.

Пошагово: приводим имена к единому виду

1. Выгрузите список файлов проекта.
2. Получите имена в генераторе, режим «Список строк».
3. Переименуйте файлы и проверьте, что расширения остались.
4. Обновите ссылки на файлы в документах и на страницах.
5. Для опубликованных файлов настройте редиректы со старых адресов.

Разбор заголовка по шагам

Возьмём заголовок «Прайс-лист на 2026 год» и пройдём путь до адреса. Пробелы заменяются дефисами, регистр приводится к нижнему.

Заголовок:           Прайс-лист на 2026 год
Без служебных слов:  Прайс-лист 2026 год
Адрес целиком:       prajs-list-na-2026-god
Адрес короче:        prajs-list-2026-god

Режим «Убрать служебные слова» в генераторе делает второй шаг сам. Короткий адрес читается легче и лучше помещается в строку браузера. Ограничения по длине и другие правила составления адреса собраны в статье «Как составить ЧПУ-адрес страницы».

Памятка для редактора

Если в проекте несколько редакторов, дайте им короткую памятку. Достаточно этих правил:

• Имя для сайта: латиница, цифры, дефис.
• Без спецсимволов и точки в конце.
• Расширение добавляем после преобразования.

Чек-лист

1. Проверить имена на запрещённые символы и зарезервированные имена.
2. Для сайта — латиница из генератора.
3. Не полагаться на регистр букв.
4. Не оставлять пробел или точку в конце.

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