MiKTeX: гайд от гика, компиляция LaTeX, пакеты, TeXworks, обновления и ограничения

↓Скачать MiKTeX

MiKTeX — не текстовый редактор в привычном смысле, а дистрибутив TeX/LaTeX: набор движков, макропакетов, шрифтов, библиографических средств, конвертеров и служебных программ, которые превращают исходный текст с разметкой в готовый PDF, DVI и другие типографские результаты. Проект поддерживается MiKTeX Project; основным разработчиком и сопровождающим исходного кода выступает Christian Schenk. Для начинающего пользователя важнее всего понять разделение ролей: MiKTeX выполняет компиляцию и обслуживание TeX-среды, а входящий в комплект TeXworks предоставляет окно редактирования исходника и встроенный просмотр PDF.

Что такое MiKTeX и для каких задач он нужен

MiKTeX реализует TeX и связанные с ним программы на Windows, macOS и выбранных Linux-дистрибутивах. Его основная задача — обеспечить рабочую локальную среду для LaTeX-документов: статей, курсовых и дипломных работ, книг, технических отчётов, формул, библиографий, презентаций и материалов, где важна воспроизводимая вёрстка. Пользователь хранит исходник в текстовом файле, обычно с расширением .tex, подключает нужные классы и пакеты, запускает один из TeX-движков и получает типографский документ.

Продукт не следует смешивать с LaTeX как языком разметки, с TeXworks как редактором или с онлайн-средами для совместной работы. LaTeX определяет команды и макросы, TeX-движок выполняет набор, TeXworks помогает редактировать и просматривать результат, а MiKTeX объединяет движки, пакетный менеджер, служебные программы и конфигурацию в одну дистрибуцию. В этом смысле ближайший аналог — TeX Live, а не Microsoft Word или PDF-редактор.

Текущий проект остаётся активным. В репозитории MiKTeX выпуск 26.5 датирован маем 2026 года; в нём обновлялись, в частности, dvipdfmx и LuaTeX. При этом номера установочных файлов на странице загрузки не обязаны совпадать с номером последнего исходного выпуска: для Windows предлагается Basic MiKTeX Installer 25.12, после установки среда обслуживается через обновления пакетов и компонентов. Это важное отличие от программ, у которых номер установщика и номер всех установленных модулей всегда одинаков.

Основные параметры

Параметр	Состояние
Тип продукта	Локальный дистрибутив TeX/LaTeX с пакетным менеджером, компиляторами и служебными утилитами
Разработчик	MiKTeX Project; Christian Schenk — основной разработчик и сопровождающий проекта
Актуальный выпуск проекта	26.5, опубликован в мае 2026 года
Windows	Windows 11 x64
macOS	macOS 12 Monterey, x64; официальный DMG на странице загрузки — x86_64
Linux	x64; поддерживаются перечисленные проектом версии Ubuntu, Linux Mint, Debian, Fedora, Rocky Linux и openSUSE Leap
Контейнер	Есть официальный Docker-образ
Редактор в комплекте	TeXworks с Unicode-редактором и встроенным PDF-просмотрщиком
Основные движки	pdfTeX/pdfLaTeX, XeTeX/XeLaTeX, LuaTeX/LuaLaTeX и другие программы TeX-экосистемы
Основной исходный формат	.tex; также используются .bib, .sty, .cls и другие служебные форматы TeX
Типичный результат	PDF или DVI; дополнительные утилиты позволяют строить PostScript и SVG в соответствующих цепочках
Пакеты	Устанавливаются через MiKTeX Console, команду miktex packages или автоматически при нехватке компонента
Интернет	Не нужен для повторной локальной компиляции уже обеспеченного проекта; нужен для обновлений и загрузки отсутствующих пакетов, если не настроен локальный репозиторий
Аккаунт	Для обычной установки, компиляции и пакетного обслуживания не требуется
Цена	Загрузка и использование MiKTeX не требуют подписки или платной редакции
Пробный период	Отдельная пробная редакция не используется: MiKTeX распространяется как открытый программный проект без платного разблокирования функций
Лицензирование	Открытый исходный код; вся дистрибуция состоит из множества компонентов с собственными свободными лицензиями
Облачная обработка	Компиляция выполняется локально; сеть используется пакетным менеджером и средствами обновления

На Windows актуальная поддержка ограничена 64-разрядной Windows 11. Это стоит сверить до загрузки: инструкции, рассчитанные на старые выпуски MiKTeX 2.9 или Windows 7/10, уже не описывают текущие системные требования. Если компьютер ещё работает на прежней версии Windows, сначала требуется решить вопрос с самой системой; для этого на GeekHow есть отдельный материал про установку Windows 11.

Платформы, варианты установки и текущий статус

На Windows основным вариантом остаётся Basic MiKTeX Installer. Он ставит базовую TeX-среду, после чего недостающие компоненты могут подгружаться по мере использования. Для развёртывания и автоматизации есть MiKTeX Setup Utility; она работает из командной строки и предназначена в том числе для автоматической установки на клиентские компьютеры. Отдельно поддерживается переносной режим: тот же установщик можно переименовать в miktex-portable.exe и разместить дистрибутив на переносном носителе. Переносная редакция запускается с переносного носителя; отдельного инсталлятора для неё нет, стандартный установщик используется под именем miktex-portable.exe.

На macOS используется Drag’n’Drop-инсталлятор в формате DMG. Текущая страница требований ограничивает платформу macOS 12 и x64, а опубликованный DMG имеет архитектуру x86_64. Для владельцев новых Mac это существенный критерий выбора: MacTeX 2026, напротив, содержит нативный код и для Intel, и для Arm. Если пользователю нужен именно привычный офисный редактор, а не TeX-среда, полезнее смотреть в сторону обычного текстового процессора; на сайте есть отдельный материал про Microsoft Word на Mac.

На Linux MiKTeX устанавливается через системный менеджер пакетов после регистрации данных GPG, которыми подписаны пакеты и метаданные репозитория проекта. Поддерживаемый набор на текущую дату включает Ubuntu 22.04, 24.04 и 26.04, Linux Mint 21 и 22, Debian 11–13, Fedora 43–44, Rocky Linux 9–10 и openSUSE Leap 15. Для пользователя, который раньше не устанавливал приложения через репозитории, полезен базовый разбор установки программ в Linux, но команды для MiKTeX нужно брать из актуального списка его собственных репозиториев.

Официальный Docker-образ даёт ещё один способ применения: он подходит для CI, автоматических сборок и машин, где проще изолировать TeX-окружение в контейнере. В контейнерном сценарии рабочий каталог монтируется внутрь образа, а компилятор запускается командой вроде pdflatex. Это не облачный сервис: контейнер работает там, где запущен Docker, и читает файлы из подключённой пользователем директории.

Как устроен интерфейс MiKTeX

У MiKTeX нет единственного «главного редактора». Пользователь взаимодействует как минимум с двумя приложениями: MiKTeX Console обслуживает дистрибутив, а TeXworks отвечает за редактирование и просмотр. Дополнительно доступны консольные команды для автоматизации. Такое разделение сначала кажется менее цельным, чем один офисный пакет, зато хорошо соответствует устройству TeX: компиляция, управление пакетами и авторский интерфейс остаются независимыми слоями.

MiKTeX Console

MiKTeX Console — графический центр обслуживания. Документированные рабочие области включают Updates для обновлений, Packages для пакетов, Settings для параметров и зарегистрированных каталогов, а также Cleanup для сброса установки на macOS и Linux. В меню Tasks находится команда Refresh file name database для обновления базы имён файлов. При общей установке Console дополнительно различает пользовательский и административный режимы обслуживания.

Для общей установки на несколько пользователей Console различает пользовательский и административный режимы. В обычном режиме меняются персональные конфигурационные данные и пакеты пользователя. Административный режим обслуживает системную часть общей установки и требует повышенных привилегий. Смешивание этих режимов — одна из причин, по которой пакет виден одному пользователю, но отсутствует в системной конфигурации.

TeXworks

TeXworks входит в MiKTeX и даёт более привычное авторское окно. Исходник редактируется как Unicode-текст, рядом или в отдельном окне открывается встроенный PDF-просмотр. Программа умеет связывать позиции исходника и PDF через SyncTeX, поэтому переход между кодом и страницей документа не требует искать фрагмент вручную. В интерфейсе предусмотрены выбор инструмента набора и команда Typeset; стандартное сочетание Ctrl+T запускает компиляцию текущего исходника.

Главная граница TeXworks состоит в том, что он не является визуальным WYSIWYG-редактором. Пользователь видит команды LaTeX, а не итоговую страницу с непосредственным редактированием объектов. Такой подход удобен для формул, ссылок, библиографии и длинных структурированных документов, но требует понимать синтаксис исходника и сообщения компилятора.

Командная строка

MiKTeX предоставляет отдельные программы и объединённую утилиту miktex для обслуживания установки. Команды miktex packages позволяют получать сведения о пакетах, устанавливать, удалять, обновлять и проверять их. Компиляторы pdflatex, xelatex и lualatex запускаются напрямую, а texify автоматизирует несколько проходов LaTeX, работу MakeIndex и BibTeX до разрешения ссылок и индексов. Для серверной сборки и повторяемых сценариев командная строка обычно важнее графического интерфейса.

Функции и рабочая модель

Компиляция LaTeX

Основная функция MiKTeX — преобразовать текстовый исходник в типографский результат. pdfLaTeX создаёт PDF напрямую через pdfTeX, XeLaTeX использует XeTeX, LuaLaTeX — LuaTeX. Выбор движка влияет на работу со шрифтами, Unicode, пакетами и расширениями языка. MiKTeX не скрывает эту разницу за единым форматом проекта: исходник остаётся обычным текстом, а конкретный движок выбирается под требования документа.

Производительность здесь зависит от характера проекта, а не от отдельного «ускорителя» в MiKTeX. Чем больше иллюстраций, шрифтов, библиографических операций и повторных проходов требуется документу, тем больше работы выполняют TeX-движки и вспомогательные программы. Универсального времени сборки проект не публикует. Для texify стандартный предел повторных проходов равен пяти; первая сборка минимальной установки дополнительно включает загрузку отсутствующих пакетов, а последующие сборки уже обеспеченного проекта выполняются локально без сетевой загрузки этих компонентов.

Для pdfTeX нативное включение графики охватывает PDF, PNG, JPEG и JBIG2. EPS напрямую в PDF-режиме не включается; его предварительно преобразуют в PDF, например утилитой epstopdf. Это важнее формального списка расширений: совместимость изображения зависит не только от MiKTeX как дистрибутива, но и от конкретного движка и используемого пакета LaTeX.

Установка отсутствующих пакетов

Характерная особенность MiKTeX — установка компонентов по мере необходимости. Когда компиляция требует пакета, которого нет в локальной среде, режим Ask me предлагает подтвердить установку, а режим Always загружает компонент автоматически. В настройках доступны режимы Ask me, Always install missing packages on-the-fly и Never install missing packages on-the-fly. Это позволяет выбрать между контролем каждой загрузки, максимальной автоматизацией и полностью предсказуемой офлайн-средой.

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

Пакетный менеджер и обновления

На странице Packages пользователь видит доступные модули и устанавливает либо удаляет их. На странице Updates проверяются новые версии. В командной строке то же семейство операций выполняется через miktex packages: доступны install, remove, update, check-update, update-package-database и verify. Для администрируемых машин это даёт возможность отказаться от ручного обслуживания через GUI.

Обновление дистрибутива и обновление конкретного документа — разные процессы. Обновление MiKTeX меняет движки и пакеты, а исходники .tex остаются отдельными файлами проекта. Поэтому после крупного обновления критичные документы следует перепроверить: среда уже использует новые версии движков и пакетов, тогда как исходный .tex остаётся прежним.

Библиография и индексы

В составе TeX-среды используются BibTeX и другие библиографические средства. texify умеет повторно запускать LaTeX/pdfLaTeX, BibTeX и MakeIndex столько раз, сколько требуется для разрешения перекрёстных ссылок и индексов, при этом по умолчанию ограничивает число итераций. Это удобнее ручного повторения одной и той же цепочки в автоматической сборке, но не отменяет необходимость правильно оформить .bib, команды цитирования и стиль библиографии.

Пользовательские TEXMF-каталоги

Собственные .sty, .cls, шрифты и другие TeX-файлы лучше хранить не внутри каталога установки, а в отдельном TEXMF-корне. MiKTeX Console умеет регистрировать пользовательский TEXMF root на странице Settings во вкладке Directories. После ручного добавления файлов обновляют FNDB — базу имён файлов, которую MiKTeX использует для ускорения поиска компонентов.

Разделение исходников, результата и временных файлов

TeX-движки создают не только PDF или DVI, но и служебные файлы: .aux, .log, данные SyncTeX и другие промежуточные результаты. MiKTeX поддерживает отдельный каталог вывода и отдельный каталог вспомогательных файлов. Это полезно в больших проектах и автоматических сборках: исходники остаются чистыми, а временные данные можно удалять без риска потерять .tex, .bib или изображения.

Локальная работа, сеть и приватность

Документ компилируется на компьютере пользователя или внутри локально запущенного контейнера; отправка исходного .tex в облачную редакцию не является частью рабочей модели MiKTeX. Сеть включается в процесс, когда пакетному менеджеру нужно получить отсутствующие компоненты, обновить каталог или скачать новую версию. Для изолированных сред MiKTeX поддерживает локальный репозиторий пакетов вместо обращения к внешнему зеркалу.

С точки зрения безопасности важно, что в стандартной конфигурации режим shell-команд ограничен значением Restricted. Разрешён только перечень команд, признанных безопасными для типичных TeX-сценариев. Включение неограниченного shell escape снимает эту защитную границу и даёт макросам возможность запускать внешние программы, поэтому такой режим следует использовать только для доверенных исходников. Для загрузочных файлов проект публикует контрольные суммы, а пакеты и метаданные Linux-репозитория защищены GPG-подписью, которую проверяет системный менеджер пакетов.

Карта форматов и совместимости

У MiKTeX нет отдельной модели «импортировать проект» и «экспортировать проект», характерной для закрытых редакторов. Компиляторы читают обычные файлы из каталога проекта, а результат создаётся выбранной TeX-цепочкой. Поэтому переносимость определяется набором исходников, ресурсов, пакетов и движком, а не контейнером проекта MiKTeX.

Формат или объект	Роль в MiKTeX	Переносимость	Что учитывать
.tex	Основной текстовый исходник TeX/LaTeX	Высокая между TeX-дистрибутивами	Нужны те же классы, пакеты, шрифты и совместимый движок
.bib	База библиографических записей	Высокая	Результат зависит от BibTeX/Biber и выбранного стиля
.sty и .cls	Пакеты и классы документов	Высокая при наличии файлов	Собственные версии лучше хранить в TEXMF-корне или вместе с проектом
PDF	Основной готовый результат	Высокая для просмотра и печати	Это уже не редактируемый LaTeX-исходник
DVI	Классический независимый от устройства результат TeX	Поддерживается TeX-инструментами	Для обычной публикации чаще удобнее PDF
PS	Результат цепочки через dvips	Нужен PostScript-совместимый просмотр или последующая конвертация	Не является прямым «Сохранить как» из TeXworks
SVG	Результат преобразования средствами dvisvgm	Подходит для веб-графики и векторного обмена	Маршрут зависит от построенного промежуточного результата
PNG/JPEG/PDF	Графика, которую pdfTeX включает в PDF-документ	Широкая	Размер, цвет и качество задаются исходным файлом и параметрами LaTeX
EPS	Классическая TeX/PostScript-графика	Хороша в DVI/PS-цепочке	pdfTeX в PDF-режиме требует предварительной конвертации в PDF
.aux, .log, .synctex.gz	Вспомогательные данные компиляции	Обычно не переносятся как содержательная часть проекта	Их можно пересоздать из исходников

Главный переносимый актив пользователя — исходники и связанные ресурсы, а не конкретная установка MiKTeX. Если .tex, .bib, изображения, локальные стили и сведения о нужном движке сохранены, проект обычно можно собрать и в другом TeX-дистрибутиве. Готовый PDF остаётся удобным для передачи получателю, но не заменяет исходник при дальнейшей правке. Если уже собранный PDF нужно редактировать как самостоятельный документ, полезнее отдельные инструменты из обзора бесплатных PDF-редакторов.

Что перестанет работать первым при отсутствии зависимостей

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

Доступ к пакетному репозиторию. TeX-движки не становятся бесполезными, но документы с ещё не установленными зависимостями перестанут собираться. Именно поэтому сценарий «минимальная установка плюс автоматическая догрузка» особенно чувствителен к сетевой доступности на первом запуске нового проекта.

Правильный PATH. TeXworks использует настроенные инструменты набора, а внешние редакторы, скрипты и терминал не находят pdflatex, xelatex или lualatex, если каталог MiKTeX отсутствует в переменной PATH либо раньше него расположен другой TeX-дистрибутив. На macOS официальная инструкция отдельно предупреждает, что каталог ~/bin может не быть в пути поиска.

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

FNDB после ручного добавления файлов. Если .sty или .cls скопирован в зарегистрированный TEXMF-каталог вручную, но база имён файлов не обновлена, новый компонент не попадает в актуальный индекс поиска. Сам файл при этом присутствует на диске, однако FNDB ещё не содержит запись о нём.

Совместимость операционной системы. На текущей Windows-ветке MiKTeX требует Windows 11 x64. На Mac официальный пакет ориентирован на x64 и macOS 12. При переходе на платформу вне текущего списка MiKTeX требуется другой поддерживаемый TeX-дистрибутив, хотя сами .tex-проекты остаются переносимыми.

Скрытая стоимость владения

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

Второй расход — трафик. Режим автоматической установки удобен на постоянном подключении, но в аудитории, лаборатории или CI без стабильной сети первая сборка останавливается, когда проект требует отсутствующую зависимость. Для такой среды лучше заранее сформировать локальный пакетный репозиторий или установить согласованный набор компонентов.

Третий расход — сопровождение воспроизводимости. Обновляемая TeX-экосистема приносит исправления, но пакетные версии меняются. Для критичных публикаций полезно фиксировать исходники, собственные стили и дату рабочей среды, а перед дедлайном не обновлять всю установку без необходимости. MiKTeX предоставляет средства обновления и проверки пакетов, но не превращает изменяющийся набор внешних пакетов в неизменяемый контейнер автоматически.

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

Наконец, есть стоимость обучения. Пользователь осваивает не только интерфейс, но и LaTeX, логи компиляции, библиографическую цепочку, различия движков и структуру TEXMF. Для короткой записки без формул это избыточно; для диссертации, технического отчёта или набора с большим числом ссылок такая модель окупается предсказуемой структурой исходника и автоматизацией повторяющихся элементов.

Как пользоваться программой — советы гика

Установка MiKTeX на Windows и первый запуск

Цель. Получить базовую пользовательскую установку, пригодную для компиляции LaTeX. Подготовка. Нужна Windows 11 x64 и загруженный Basic MiKTeX Installer. Действия. Запустите установщик, примите пункт I accept the MiKTeX copying conditions и нажмите Next. Если доступны варианты области установки, для обычного персонального компьютера выберите private/per-user setup. Подтвердите каталог, задайте формат бумаги и поведение автоматического установщика пакетов, затем перейдите к Review и нажмите Start. После завершения нажмите Close. Проверка. В меню приложений должны появиться MiKTeX Console и TeXworks. Типичная ошибка. Выбор shared setup без реальной необходимости усложняет дальнейшее обслуживание и требует административных прав. Безопасный откат. До создания проектов установку можно удалить штатным способом Windows; пользовательские .tex-файлы храните вне каталога MiKTeX.

Установка и завершение настройки на macOS и Linux

Цель. Получить рабочую MiKTeX-среду на поддерживаемой x64-системе вне Windows. Подготовка. Для macOS нужна macOS 12 x64 и официальный DMG; для Linux — одна из поддерживаемых версий Ubuntu, Mint, Debian, Fedora, Rocky Linux или openSUSE Leap. Действия. На macOS откройте DMG и перетащите MiKTeX в Applications, затем запустите MiKTeX Console и выберите private либо shared setup. На Linux установите пакет из репозитория MiKTeX средствами своего дистрибутива, затем завершите частную настройку командой miktexsetup finish или системную настройку командой sudo miktexsetup —shared=yes finish. Проверка. MiKTeX Console запускается, а lualatex или другой установленный движок доступен из каталога, созданного выбранной областью установки. Типичная ошибка. На macOS каталог ~/bin отсутствует в PATH, из-за чего внешняя оболочка не видит установленные программы. Безопасный откат. На macOS и Linux перед удалением откройте Cleanup и выполните Reset the TeX installation to factory defaults; это сбрасывает созданную MiKTeX-конфигурацию до начального состояния.

Настройки после установки: режим пакетов, формат бумаги и область обслуживания

Цель. Привести среду к предсказуемому состоянию до первого документа. Подготовка. Запустите MiKTeX Console. При общей установке Console предложит Switch to MiKTeX administrator mode или Stay in MiKTeX user mode; выбирайте ту область, которую действительно собираетесь обслуживать. Действия. Откройте Settings, вкладку General. Проверьте формат бумаги. Для установки зависимостей выберите Ask me, если хотите подтверждать каждую загрузку; Always install missing packages on-the-fly — для автоматической догрузки; Never install missing packages on-the-fly — для полностью контролируемой среды. Проверка. После закрытия и повторного открытия Settings выбранные значения должны сохраниться. Типичная ошибка. Режим Never при минимальной установке приводит к ошибкам на первом документе с неустановленным пакетом. Безопасный откат. Верните Ask me — это нейтральный вариант с подтверждением каждой установки.

Обновление базовой установки перед первым проектом

Цель. Установить доступные исправления после загрузки базового инсталлятора. Подготовка. Нужен доступ к сети и правильный пользовательский либо административный режим. Действия. В MiKTeX Console откройте Updates, нажмите Check for Updates, дождитесь списка и затем выберите Update now. Не закрывайте Console во время записи компонентов. Проверка. Повторный Check for Updates не должен показывать тот же набор обязательных обновлений. Типичная ошибка. Запуск обновления не в той области общей установки оставляет вторую область на старом наборе. Безопасный откат. Не прерывайте уже начатую установку; при проблеме сначала сохраните диагностический отчёт и восстановите согласованность повторным обновлением, а не ручным удалением отдельных файлов.

Создание первого .tex-документа в TeXworks

Цель. Подготовить минимальный исходник, который можно собрать в PDF. Подготовка. Откройте TeXworks и создайте новый текстовый файл. Действия. Введите минимальную структуру LaTeX: команду documentclass, затем begin document, текст и end document. Сохраните файл с расширением .tex в отдельной папке проекта. Исходник, изображения и .bib лучше держать рядом или в понятной структуре подпапок. Проверка. Имя окна TeXworks должно показывать сохранённый .tex-файл; повторное открытие не должно менять кодировку текста. Типичная ошибка. Сохранение как обычного .txt приводит к тому, что выбранный TeX-инструмент не воспринимает файл как основной LaTeX-исходник. Безопасный откат. Используйте Save As и сохраните копию с расширением .tex, не удаляя исходный текст.

Компиляция PDF и выбор TeX-движка

Цель. Получить готовый PDF и увидеть сообщения компилятора. Подготовка. Исходник сохранён на диске. Действия. В выпадающем списке инструмента Typeset выберите pdfLaTeX для обычной PDF-сборки или XeLaTeX для проекта, рассчитанного на системные OpenType-шрифты и Unicode-возможности XeTeX. Нажмите Typeset или Ctrl+T. LuaLaTeX входит в MiKTeX как отдельный компилятор; для сборки им выполните lualatex main.tex в терминале из каталога проекта. Проверка. После Typeset TeXworks откроет PDF во встроенном просмотрщике; после консольной сборки PDF появится в каталоге проекта. Типичная ошибка. Смена движка без учёта пакетов и шрифтов приводит к сообщениям компилятора для исходника, рассчитанного на другой движок. Безопасный откат. Верните прежний инструмент и повторите сборку; .tex при компиляции не переписывается.

Автоматическая установка пакета, которого нет в системе

Цель. Дособрать проект, зависящий от неустановленного компонента. Подготовка. В Settings должно быть разрешено Ask me или Always install missing packages on-the-fly, а сеть должна быть доступна. Действия. Запустите компиляцию. В режиме Ask me MiKTeX покажет диалог подтверждения установки отсутствующего пакета; подтвердите загрузку. После установки компиляция продолжится или её можно запустить повторно. Проверка. В MiKTeX Console на странице Packages компонент будет отмечен как установленный, а сообщение о его отсутствии исчезнет. Типичная ошибка. Нажатие Cancel оставляет зависимость нерешённой. Безопасный откат. Если пакет оказался лишним, удалите его через Packages; исходники проекта при этом не меняются.

Ручная установка, удаление и проверка пакетов

Цель. Управлять зависимостями до компиляции, а не по ходу работы. Подготовка. Откройте Packages в MiKTeX Console. Действия. Найдите пакет по имени, выделите его и используйте кнопку добавления для установки либо удаления для деинсталляции. Для автоматизированной среды применяйте командную форму miktex packages install с идентификатором пакета; команда verify проверяет целостность установленных пакетов. Проверка. Статус пакета в списке должен измениться, а компилятор должен находить соответствующие файлы. Типичная ошибка. Удаление пакета, от которого зависят другие документы, ломает их следующую сборку. Безопасный откат. Снова установите тот же пакет из репозитория.

Подключение собственного TEXMF-каталога для .sty и .cls

Цель. Хранить локальные классы и стили отдельно от системной установки. Подготовка. Создайте TEXMF-корень и разместите собственные файлы в правильной структуре, например tex/latex/mystuff. Действия. В MiKTeX Console откройте Settings, затем Directories, нажмите кнопку Add и выберите корневой каталог TEXMF. После копирования или изменения файлов откройте Tasks и выполните Refresh file name database. Проверка. Компиляция документа, подключающего этот .sty или .cls, должна проходить без сообщения file not found. Типичная ошибка. Регистрация слишком глубокой подпапки вместо корня нарушает структуру поиска. Безопасный откат. Удалите ошибочную запись из Directories и зарегистрируйте правильный корень; сами пользовательские файлы не нужно удалять.

Автоматическая сборка со ссылками, BibTeX и индексом через texify

Цель. Избавиться от ручного повторения LaTeX, BibTeX и MakeIndex. Подготовка. Основной файл должен быть сохранён, а библиографические и индексные команды — корректно описаны в исходнике. Действия. Откройте терминал в папке проекта и выполните texify —pdf main.tex. Утилита повторяет нужные проходы до разрешения перекрёстных ссылок и индексов; для ограничения цикла предусмотрен max-iterations. Проверка. Итоговый PDF должен содержать сформированные ссылки, библиографию и индекс без сообщений о необходимости следующего прохода. Типичная ошибка. Ошибка в .bib или исходнике не устраняется дополнительными итерациями. Безопасный откат. Исправьте исходный файл и повторите команду; для удаления промежуточных файлов используйте texify —clean только после сохранения исходников.

Разделение PDF и временных файлов по разным каталогам

Цель. Не засорять папку исходников файлами .aux, .log и другими промежуточными результатами. Подготовка. Создайте отдельные каталоги для готового вывода и служебных данных. Действия. При запуске LaTeX задайте output-directory для готового результата и aux-directory для вспомогательных файлов. Для простого проекта достаточно одного output-directory; второй параметр полезен в автоматической сборке. Проверка. PDF должен находиться в каталоге результата, а .log и другие служебные файлы — в каталоге вспомогательных данных. Типичная ошибка. Путь, в который процесс не имеет права записи, останавливает создание результата; отсутствующие каталоги output-directory и aux-directory MiKTeX по умолчанию создаёт автоматически. Безопасный откат. Уберите параметры и верните вывод в рабочую папку; исходник не меняется.

Сквозной сценарий: от нового исходника до переносимого результата

Цель. Получить воспроизводимый документ и не зависеть от состояния окна редактора. Подготовка. MiKTeX обновлён, режим пакетов выбран, проект хранится в отдельной папке. Действия. Создайте main.tex в TeXworks, сохраните его, выберите подходящий движок и выполните Typeset. Если MiKTeX попросит зависимость, установите её. Исправьте ошибки по консольному сообщению, повторите компиляцию и проверьте PDF во встроенном просмотрщике. Для документа с библиографией и индексом выполните финальную сборку texify —pdf main.tex. Сохраните вместе main.tex, .bib, изображения и собственные стили; PDF оставьте как готовый экземпляр для чтения. Проверка. Закройте TeXworks, снова откройте main.tex и повторите сборку: результат должен создаваться из сохранённых файлов, а не из несохранённого состояния редактора. Типичная ошибка. Передача только PDF лишает получателя редактируемого TeX-проекта. Безопасный откат. Не удаляйте исходники после публикации; промежуточные .aux и .log можно пересоздать.

Плюсы

• MiKTeX объединяет TeX-движки, пакетный менеджер, служебные программы и TeXworks, поэтому после одной установки пользователь получает полноценную локальную LaTeX-среду.
• Недостающие пакеты можно устанавливать по мере использования, не загружая сразу полный набор дистрибутива.
• Автоматическую догрузку легко перевести в режим Ask me или полностью отключить, что удобно для контролируемых и офлайн-сред.
• MiKTeX Console разделяет обновления, пакеты, настройки, диагностику и очистку, а командная строка покрывает те же задачи для автоматизации.
• Поддерживаются частная пользовательская и общая системная установки, а на Windows есть переносный вариант, запускаемый с переносного носителя.
• TeXworks даёт встроенный PDF-просмотр и SyncTeX, поэтому исходник и готовую страницу можно сопоставлять без внешнего PDF-приложения.
• Есть официальный Docker-образ, подходящий для повторяемых автоматических сборок.
• Исходники остаются обычными текстовыми файлами и не привязаны к закрытому проектному формату MiKTeX.

Минусы

• Актуальная Windows-ветка требует Windows 11 x64; старые инструкции для Windows 7/10 больше не соответствуют текущим требованиям.
• На macOS текущие требования и опубликованный DMG ориентированы на x64, тогда как MacTeX 2026 поддерживает Intel и Arm нативно.
• Минимальная установка зависит от сети при первом использовании редких пакетов; без локального репозитория сборка нового проекта останавливается на недостающей зависимости.
• Разделение между MiKTeX Console, TeXworks и консольными утилитами увеличивает порог освоения по сравнению с единым визуальным редактором.
• Общая установка требует внимательно различать user mode и administrator mode; пакеты и конфигурация этих областей обслуживаются отдельно.
• После обновления пакетов критичные проекты нужно перепроверять, потому что они собираются уже новым набором компонентов.
• MiKTeX не даёт совместного браузерного редактирования, истории команды и серверного проекта как облачные LaTeX-сервисы.
• Для пользователя, которому нужна только короткая записка без формул и сложной структуры, изучение LaTeX и диагностики компиляции избыточно.

Кому подойдёт

• Студентам и исследователям, которые пишут документы с большим количеством формул, перекрёстных ссылок и библиографии.
• Авторам технической документации и книг, где структура исходника важнее визуального перетаскивания объектов на странице.
• Пользователям Windows 11, которым нужен TeX-дистрибутив с графическим менеджером пакетов и автоматической установкой зависимостей.
• Разработчикам, которые собирают LaTeX в скриптах, CI или Docker и хотят управлять пакетами из командной строки.
• Пользователям, которые хотят хранить исходники локально и передавать проект как набор обычных текстовых файлов и ресурсов.
• Администраторам учебных компьютерных классов, если заранее определены пользовательский или общий режим и политика обновлений.

Кому не подойдёт

• Тем, кто ожидает WYSIWYG-редактор с непосредственным форматированием страницы мышью.
• Пользователям Windows 10 и более старых систем, поскольку текущие требования MiKTeX для Windows указывают Windows 11 x64.
• Владельцам Apple Silicon, которым требуется нативный Arm-дистрибутив без опоры на x64-пакет MiKTeX; здесь практичнее MacTeX 2026.
• Командам, которым прежде всего нужны совместное редактирование в браузере, роли и общая облачная история проекта.
• Пользователям без возможности освоить LaTeX-синтаксис, логи и различия движков.
• Офлайн-машинам, на которые поставлена только минимальная среда без заранее загруженных пакетов или локального репозитория.

Сравнение с другими аналогами

Решение	Основная задача	Платформы	Порог освоения	Форматы и движки	Автоматизация	Модель оплаты	Ограничение	Подходящий сценарий
MiKTeX	Полная локальная TeX/LaTeX-среда с установкой пакетов по мере необходимости	Windows 11 x64, macOS 12 x64, выбранные Linux x64, Docker	Средний: Console упрощает обслуживание, но LaTeX нужно изучать	pdfTeX, XeTeX, LuaTeX, PDF/DVI и дополнительные конвертеры	miktex, texify, пакетный менеджер, Docker	Без подписки, открытый исходный код	Текущая поддержка ОС и архитектур уже, чем у TeX Live	Windows-пользователь или CI, которому нравится автоматическая догрузка пакетов
TeX Live 2026	Универсальный TeX-дистрибутив TeX Users Group	Windows, macOS, GNU/Linux и другие Unix-платформы	Средний: установка и tlmgr требуют понимания структуры TeX Live	Большой набор движков, макросов, шрифтов и документации	tlmgr, профиль установки, командная строка	Свободная дистрибуция	Полная установка по умолчанию занимает более 7 ГБ	Пользователь, которому нужна максимально стандартная кроссплатформенная TeX-среда
MacTeX 2026	Готовая macOS-сборка TeX Live с Mac-приложениями	macOS 11 и новее, Intel и Arm	Ниже на Mac: после установки среда полностью настроена	Полный TeX Live плюс TeXShop, BibDesk, TeX Live Utility и другие Mac-инструменты	tlmgr и TeX Live Utility	Бесплатно для личного и профессионального использования	Полный пакет около 6,4 ГБ	Современный Mac, особенно Apple Silicon
Tectonic 0.17	Самодостаточный современный TeX/LaTeX-движок с загрузкой поддерживающих файлов по мере необходимости	Есть готовые сборки и пакетные способы для основных настольных ОС	Ниже для простой CLI-сборки	Ориентирован на TeX→PDF, основан на XeTeX и материалах TeX Live	Автоматически повторяет нужные проходы TeX/BibTeX; удобен в CI	MIT, открытый исходный код	Это не классический полный дистрибутив с графическим менеджером и множеством отдельных TeX-программ	Автоматическая воспроизводимая PDF-сборка одним исполняемым файлом

Для Windows MiKTeX особенно привлекателен своей моделью «поставить базу и догружать нужное». TeX Live выбирают, когда нужна стандартная структура TUG и широкий набор платформ. На Mac преимущество MacTeX связано не только с удобным инсталлятором, но и с нативной поддержкой Arm. Tectonic уместен, когда приоритетом является автоматическая сборка с минимальным ручным обслуживанием традиционного TeX-дерева.

Типичные проблемы и диагностика

Компиляция сообщает, что .sty или пакет не найден

Симптом: LaTeX останавливается на сообщении File not found для пакета. Причина: зависимость отсутствует, а автоматическая установка отключена либо загрузка недоступна. Диагностика: найдите имя пакета в MiKTeX Console на странице Packages и проверьте его статус; также проверьте режим установки на Settings → General. Исправление: установите пакет вручную или включите Ask me/Always для догрузки. Проверка: повторная компиляция проходит дальше той же строки без сообщения об отсутствующем файле.

MiKTeX не видит вручную добавленный .sty или .cls

Симптом: файл физически лежит в пользовательском каталоге, но TeX его не находит. Причина: каталог не зарегистрирован как TEXMF root либо FNDB не обновлена после ручного копирования. Диагностика: проверьте Settings → Directories и структуру tex/latex внутри корня. Исправление: зарегистрируйте правильный корень и выполните Tasks → Refresh file name database. Проверка: тот же документ собирается без переноса .sty в системный каталог.

В терминале не находится pdflatex, xelatex или lualatex

Симптом: оболочка сообщает, что команда не найдена, хотя MiKTeX установлен. Причина: каталог исполняемых файлов не присутствует в PATH. На macOS инструкция MiKTeX отдельно указывает на ~/bin. Диагностика: проверьте, какой исполняемый файл находит система, либо убедитесь, что путь MiKTeX отсутствует. Исправление: добавьте каталог MiKTeX в PATH в соответствии с платформой. Проверка: команда pdflatex —version запускается из нового окна терминала.

Установлены MiKTeX и TeX Live, но запускается не тот компилятор

Симптом: версия пакета или путь в логе не соответствует ожидаемой установке. Причина: каталоги bin двух дистрибутивов пересекаются в PATH. MiKTeX допускает параллельную установку с TeX Live, но их bin-каталоги должны оставаться различимыми. Диагностика: определите полный путь найденного pdflatex. Исправление: измените порядок PATH или настройку редактора так, чтобы он использовал нужный bin. Проверка: версия и путь компилятора совпадают с выбранным дистрибутивом.

Пакет установлен в user mode, но не виден в administrator mode

Симптом: один и тот же пакет отмечен по-разному при обычном и административном запуске Console. Причина: MiKTeX хранит пользовательскую и системную части общей установки отдельно. Диагностика: уточните текущий режим Console и область, в которой установлен пакет. Исправление: обслуживайте пакет в той области, из которой запускается компилятор, либо установите его системно для общего сценария. Проверка: нужный режим Console показывает пакет установленным, а компиляция из той же области находит его.

EPS не включается при сборке через pdfLaTeX

Симптом: pdfLaTeX не принимает EPS-графику в прямом PDF-режиме. Причина: pdfTeX нативно работает с PDF, PNG, JPEG и JBIG2, но не включает PostScript/EPS напрямую. Диагностика: проверьте расширение изображения и выбранный движок. Исправление: преобразуйте EPS в PDF с помощью epstopdf либо используйте DVI/PostScript-цепочку, соответствующую проекту. Проверка: PDF собирается и содержит изображение без ошибки формата.

Ссылки или номера остаются неопределёнными после одного прохода

Симптом: в PDF есть знаки вопроса вместо ссылок или лог просит повторить LaTeX. Причина: перекрёстные ссылки и оглавление требуют повторных проходов. Диагностика: изучите предупреждения в .log. Исправление: повторите компиляцию либо используйте texify, который сам выполняет нужные итерации и связанные утилиты. Проверка: предупреждение о повторном проходе исчезает, номера и ссылки становятся определёнными.

Библиография не появляется, хотя .bib существует

Симптом: список литературы пуст или цитаты не разрешаются. Причина: библиографический процесс не был выполнен либо .bib содержит ошибку. Диагностика: проверьте сообщения BibTeX/LaTeX и имя базы в исходнике. Исправление: исправьте .bib и выполните полную цепочку через texify —pdf либо настроенный инструмент библиографии. Проверка: цитаты получают номера или авторские метки, а список литературы появляется в PDF.

Первый запуск нового проекта останавливается на установке пакета

Симптом: сборка ждёт решения пользователя или не может продолжиться без сети. Причина: минимальная установка не содержит редкую зависимость, а выбран режим Ask me либо репозиторий недоступен. Диагностика: определите имя отсутствующего пакета и проверьте сетевое соединение. Исправление: разрешите установку или заранее добавьте пакет через Packages; для закрытой сети используйте локальный репозиторий. Проверка: повторный запуск того же проекта больше не требует этой загрузки.

После обновления старый документ собирается иначе

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

MiKTeX Console обновляет не ту часть общей установки

Симптом: после Update now один пользователь видит новые компоненты, а системный запуск остаётся на старом состоянии. Причина: обновление выполнено только в user mode или только в administrator mode. Диагностика: посмотрите режим Console перед проверкой обновлений. Исправление: повторите обслуживание в требуемой области общей установки. Проверка: версии пакетов совпадают в той области, откуда запускается рабочий компилятор.

FAQ

Почему на странице загрузки Windows-инсталлятор называется 25.12, а актуальный выпуск проекта — 26.5?

Номер базового установочного файла и номер последнего выпуска исходного проекта отражают разные уровни поставки. На текущей странице загрузки Windows-файл называется basic-miktex-25.12-x64.exe, тогда как выпуск исходного проекта 26.5 опубликован в мае 2026 года. После установки компоненты и пакеты обслуживаются через механизм обновлений MiKTeX, поэтому номер первоначального EXE не описывает версии всех файлов в уже обновлённой среде.

Чем Basic MiKTeX Installer отличается от MiKTeX Setup Utility?

Basic MiKTeX Installer рассчитан на обычную интерактивную установку Windows. MiKTeX Setup Utility — командный инструмент для скачивания, установки и удаления дистрибутива; он предназначен в том числе для автоматизированного развёртывания на нескольких компьютерах. Это разные способы развернуть одну TeX-среду, а не платная и бесплатная редакции.

Можно ли задать имя PDF, не совпадающее с именем .tex?

Да. TeX-движки MiKTeX принимают параметр job-name: например, исходник cat.tex при значении job-name=dog создаёт dog.pdf. Это меняет имя результата, но не переименовывает исходный файл.

Где MiKTeX хранит диагностические сообщения своих программ?

Исполняемые программы MiKTeX записывают действия в журнальные .log-файлы. Конкретный каталог зависит от операционной системы и области установки; MiKTeX Console показывает каталог журналов, поэтому для диагностики не требуется угадывать системный путь вручную.

Почему пакет с известным названием отсутствует в репозитории MiKTeX?

Официальная справка выделяет две причины: пакет настолько новый, что ещё не добавлен сопровождающими MiKTeX, либо его лицензия не соответствует требованиям, применяемым к содержимому репозитория. В такой ситуации отсутствие записи в Packages отличается от обычного статуса «не установлен».

Какие сведения о пакете показывает командная утилита?

Команда семейства miktex packages info умеет выводить, среди прочего, идентификатор и название пакета, версию и дату версии, тип лицензии, состояние установки, зависимости, размеры архивов и файлов, путь CTAN и сведения о том, какими пакетами компонент требуется. Это полезно при аудите окружения без графического интерфейса.

Разрешено ли коммерческое использование MiKTeX?

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

TeXworks принудительно сохраняет исходники только в UTF-8?

Нет. TeXworks построен как Unicode-редактор, но поддерживает несколько кодировок файлов и варианты окончаний строк для совместимости между системами. Конкретная кодировка исходника должна согласовываться с используемым TeX-движком и настройками документа.

texify работает только с LaTeX?

Нет. Драйвер различает LaTeX и Texinfo по типу входного файла; для Texinfo он использует makeinfo при необходимости макрорасширения. Поэтому texify шире, чем простая оболочка вокруг одного запуска pdflatex.

Что означает режим texify —batch?

Параметр batch отключает интерактивное взаимодействие во время работы texify. Он предназначен для сценариев, где сборка должна завершиться без диалогов, например в автоматическом процессе, а ошибки затем анализируются по коду завершения и журналу.

Нужно ли заранее создавать каталог для output-directory и aux-directory?

Нет. В текущих значениях MiKTeX включено автоматическое создание отсутствующего каталога, указанного в output-directory, и отдельного каталога aux-directory. Ограничение остаётся обычным для файловой системы: процессу нужны права записи в выбранное место.

Итог по сценариям использования

Для Windows 11 MiKTeX остаётся рациональным выбором, когда нужен локальный LaTeX-дистрибутив с понятным графическим обслуживанием и установкой пакетов по мере необходимости. В учебной и научной работе его сильная сторона проявляется не в визуальном редактировании, а в сочетании TeXworks, движков, пакетного менеджера и автоматических служебных цепочек.

Для современного Mac выбор менее однозначен. Если компьютер на Apple Silicon и важна нативная поддержка Arm, MacTeX 2026 выглядит практичнее, потому что текущий MiKTeX-пакет для Mac ориентирован на x64. На Linux MiKTeX подходит тем, кто хочет ту же модель автоматических пакетов, что и на Windows, и работает на одной из поддерживаемых x64-систем.

Для автоматической сборки есть два разных пути. MiKTeX хорош, если проекту нужен классический набор TeX-программ, управляемые пакеты и Docker. Tectonic проще там, где нужен один исполняемый инструмент, автоматические повторные проходы и воспроизводимая PDF-сборка без традиционного полного TeX-дерева. TeX Live предпочтительнее, когда на первом месте стандартная кроссплатформенная дистрибуция TUG и максимально полный набор компонентов.

MiKTeX не заменяет визуальный офисный редактор и не решает совместную работу в браузере. Его ценность в другом: исходник остаётся текстовым, компиляция выполняется локально, а пакетный менеджер позволяет постепенно собрать именно ту TeX-среду, которая нужна конкретным документам. Выбирать его стоит тогда, когда этот способ работы соответствует проекту и текущая платформа входит в официальный список поддержки.