Mojibake Fixer — исправление крокозябр, битой кириллицы и UTF-8 BOM

Mojibake Fixer — универсальный скрипт для исправления проблем кодировки в коде и текстовых файлах:

• крокозябры (mojibake)
• битый русский текст / сломанная кириллица
• UTF-8 BOM в начале файлов

Подходит для реальных репозиториев с разными форматами: PHP, JavaScript, TypeScript, Python, HTML, CSS, JSON, YAML, XML, Markdown.

Что решает

• Исправляет строки вида Привет обратно в Привет
• Восстанавливает русский текст после неверной перекодировки
• Удаляет UTF-8 BOM, который может ломать парсинг, заголовки и CI/CD
• Рекурсивно обходит проект
• Поддерживает безопасный режим предпросмотра --dry-run
• Автоматически устанавливает ftfy, если пакет не найден

SEO-ключи

исправить крокозябры, исправить кодировку, исправить битую кириллицу, исправить русский текст, utf-8 bom remover, remove bom, fix mojibake, mojibake fixer, ошибка кодировки, кракозябры в php, битый текст в utf-8

Быстрый старт

1. Сначала посмотреть, что будет изменено

python scripts/fix_mojibake.py . --dry-run

Windows fallback:

py -3 scripts/fix_mojibake.py . --dry-run

2. Применить исправления

python scripts/fix_mojibake.py .

3. Ограничить обработку нужными расширениями

python scripts/fix_mojibake.py . --extensions .php .js .ts .css .html .md .json .yaml .xml .py

Типовые кейсы

• После переноса файлов русский текст стал нечитаемым
• После редактирования в другом редакторе появились крокозябры
• В CI падает YAML/JSON из-за скрытого BOM
• В шаблонах фронтенда кириллица отображается как мусор

Расширения по умолчанию

.php, .phtml, .html, .htm, .js, .ts, .tsx, .jsx, .css, .scss, .sass, .less, .json, .xml, .yml, .yaml, .md, .txt, .sql, .ini, .conf, .py

Важно

• Скрипт обрабатывает UTF-8 текстовые файлы и пропускает бинарные
• Перед массовыми изменениями используйте --dry-run
• Рекомендуется запускать в отдельной git-ветке

Использование как Codex Skill

Этот репозиторий можно использовать как skill, где исправление кодировки выполняется только через скрипт:

• python scripts/fix_mojibake.py ...
• py -3 scripts/fix_mojibake.py ... (Windows fallback)

Установка skill в Codex

Чтобы установить существующий skill:

1. Откройте Codex в терминале
2. Введите $
3. Выберите Skill Installer
4. Введите имя skill или вставьте GitHub URL
5. Дождитесь установки skill в Codex
6. Перезапустите Codex

Лицензия

MIT