Часто задаваемые вопросы
Обзор главы
Эта глава охватывает распространенные проблемы и методы устранения неполадок плагина opencode-md-table-formatter, помогая вам быстро находить и решать различные проблемы, возникающие в процессе форматирования таблиц.
Навигация по подстраницам
FAQ: Что делать, если таблица не форматируется
Полное введение в распространенные проблемы и решения при использовании плагина:
- Таблица не форматируется: проверка конфигурации, требований к версии, перезапуск OpenCode
- Недопустимая структура таблицы: понимание смысла ошибки "invalid structure", изучение правильного синтаксиса таблиц
- Сбой форматирования: обработка ошибок "table formatting failed" и аномальных ситуаций
- Неподдерживаемые типы таблиц: понимание ограничений для HTML-таблиц, многострочных ячеек и других сценариев
- Невыровненное форматирование: выявление скрытых режимов, сверхдлинных ячеек, встроенного кода и других проблем
Рекомендации по обучению
Рекомендуется изучить этот раздел после ознакомления с обзором функций и обратиться к нему при возникновении реальных проблем или использовать как справочник по устранению неполадок.
Вы можете учиться в следующем порядке:
- При возникновении проблем: сначала определите тип проблемы по симптомам (таблица не форматируется, сообщения об ошибках и т. д.)
- Постепенная диагностика: последовательно проверяйте каждый пункт из контрольного списка руководства по устранению неполадок
- Глубокое понимание: изучите спецификацию таблиц и принципы скрытого режима для понимания технических деталей
- Известные ограничения: ознакомьтесь с ограничениями для понимания границ работы плагина
Требования
Перед изучением этой главы рекомендуется выполнить:
- ✅ Быстрый старт: установка и конфигурация - ознакомьтесь с процессом установки и настройки плагина
- ✅ Обзор функций: магия автоматического форматирования - понимание основных функций и принципов работы плагина
Кроме того, вы должны обладать:
- Знанием основ синтаксиса Markdown-таблиц
- Пониманием способов настройки плагинов в OpenCode (
opencode.jsonc)
Следующие шаги
После завершения этой главы вы можете продолжить обучение:
Расширенные знания:
- Спецификация таблиц: какие таблицы можно форматировать - освоение требований к структуре валидных таблиц
- Принципы скрытого режима: почему расчет ширины так важен - понимание принципа работы скрытого режима OpenCode
- Детальное описание выравнивания: по левому краю, по центру, по правому краю - освоение синтаксиса и эффектов трех способов выравнивания
Технические детали:
- Известные ограничения: где заканчиваются границы плагина - ознакомление с известными ограничениями и сценариями, где плагин не применяется
- Технические детали: механизм кэширования и оптимизация производительности - понимание внутреннего механизма кэширования и стратегии оптимизации производительности плагина