🛠️ Troubleshooting (если что-то не работает)

Подборка симптомов и быстрых решений.

«Command not found» / «Не является внутренней или внешней командой»

• Проверьте PATH: ~/.cargo/bin (Linux/macOS) или %USERPROFILE%\.cargo\bin (Windows).
• На macOS дайте разрешение на запуск бинарника (если скачивали архив): bash chmod +x ./rimloc-cli ./rimloc-cli --help

Ошибки плейсхолдеров после импорта

• Запустите проверку .po до импорта: bash rimloc-cli validate-po --po ./MyMod.ru.po --strict
• Сверьте проблемные строки: плейсхолдеры должны совпадать с оригиналом (регистр и форма: %s, %d, {0}, {NAME} и т. п.). См. glossary.md#плейсхолдер

Пустые или дублирующиеся ключи

• Проверьте исходные XML: bash rimloc-cli validate --root ./Mods/MyMod --format text
• Если это «ожидаемые пустоты» — используйте соответствующие флаги/исключения.

Неправильная кодировка символов

• Убедитесь, что редактор сохраняет файлы в UTF‑8 без BOM.
• Проверьте xml-health: ../cli/xml_health.md

Импорт ничего не меняет

• В .po нет непустых msgstr.
• Ключи/пути не совпадают с исходными XML.
• Запустите с --report --dry-run, чтобы увидеть сопоставление ключей.

Сборка RU‑мода содержит лишнее

• Уточните флаги build-mod — например, --lang и метаданные пакета.
• Для точной настройки см. cli/build_mod.md

Если проблема не решилась — загляните в Discord (страница Community → Discord) и приложите команды + вывод.