Установка Lua на Windows¶

Установка Lua на Windows — процесс размещения интерпретатора и стандартной библиотеки языка программирования Lua на операционной системе Microsoft Windows. Lua — компактный скриптовый язык, распространяемый под лицензией MIT; его основной способ распространения — исходный код, который компилируется под конкретную платформу. На Windows доступны как официальный путь сборки из исходников, так и готовые бинарные дистрибутивы и менеджеры пакетов.

¶Способы установки

На Windows Lua можно установить несколькими способами:

• Компиляция из исходного кода — официальный рекомендуемый метод; требует наличия компилятора C и утилиты make.
• Готовые бинарные пакеты — распространяются через сторонние сайты и репозитории, содержат интерпретатор lua.exe и библиотеки в виде DLL.
• Менеджеры пакетов — Chocolatey, Scoop, winget, vcpkg и аналоги позволяют установить Lua одной командой.
• Сборки, входящие в состав интегрированных сред — например, Lua для Windows (LuaForWindows), объединяющий интерпретатор, редактор и дополнительные библиотеки.

¶Установка из исходного кода

¶Подготовка инструментов

Для сборки Lua из исходников на Windows требуется набор MinGW/MSYS2 (предоставляет компилятор gcc и утилиту make) либо Visual Studio с компонентом C++ и утилитой nmake. Наиболее распространённый путь — использование MSYS2:

1. Устанавливается MSYS2 с официального сайта.
2. Через оболочку MSYS2 устанавливаются инструменты: pacman -S mingw-w64-ucrt-x86_64-gcc make.
3. Каталог C:\msys64\ucrt64\bin добавляется в переменную среды PATH.

¶Сборка

Исходный код Lua скачивается с официального сайта lua.org (папка ftp или раздел загрузок). В каталоге с исходниками выполняется команда:

`` make mingw ``

После успешной сборки в каталоге появляются исполняемый файл lua.exe, файл luac.exe (компилятор байт-кода) и библиотека liblua.a. Для использования достаточно скопировать lua.exe в каталог, добавленный в PATH, либо добавить в PATH сам каталог сборки.

¶Сборка под Visual Studio

Для сборки под MSVC используется утилита nmake с файлом makefile из подкаталога src:

`` nmake a ``

Такой вариант предпочтителен, если проекты, использующие Lua, собираются именно компилятором MSVC, поскольку бинарная совместимость объектных файлов и статических библиотек между GCC и MSVC не гарантируется.

¶Установка менеджерами пакетов

¶Chocolatey

При установленном менеджере Chocolatey команда

`` choco install lua ``

устанавливает готовый пакет и добавляет lua.exe в PATH.

¶Scoop

`` scoop install lua ``

¶winget

`` winget install Lua.Lua ``

Точные идентификаторы пакетов могут различаться в зависимости от версии менеджера и репозитория.

¶vcpkg

Для подключения Lua как библиотеки к проектам на C/C++ используется vcpkg:

`` vcpkg install lua ``

После этого библиотека доступна для подключения через интеграцию с Visual Studio или CMake.

¶LuaForWindows

LuaForWindows — распространявшийся готовый дистрибутив, включавший интерпретатор Lua, редактор SciTE, библиотеки (LuaSocket, LuaFileSystem, lpeg и другие) и документацию. Проект долгое время не обновлялся и считается устаревшим; вместо него сообщество рекомендует использовать самостоятельную сборку или менеджеры пакетов. Тем не менее установка LuaForWindows остаётся самым простым способом получить полный набор инструментов «из коробки».

¶Проверка установки

После установки открывается командная строка (cmd или PowerShell) и выполняется:

`` lua -v ``

Корректный ответ содержит номер версии, например Lua 5.4.6. Для проверки работы достаточно выполнить:

`` lua -e "print('hello')" ``

¶Настройка переменных среды

Чтобы запускать lua из любого каталога, каталог с lua.exe добавляется в переменную среды PATH:

1. Открывается «Система» → «Дополнительные параметры системы» → «Переменные среды».
2. В списке пользовательских или системных переменных редактируется PATH.
3. Добавляется путь к каталогу с lua.exe.

После применения изменений командная строка должна быть перезапущена.

¶Типичные проблемы

• lua.exe не найден — каталог не добавлен в PATH или изменения не применены после перезапуска оболочки.
• Ошибка при запуске DLL — рядом с lua.exe отсутствует соответствующая lua54.dll; проблема возникает при использовании готовых бинарных пакетов без копирования библиотеки.
• Ошибка компиляции при сборке — отсутствуют утилиты make или компилятор C; в MSYS2 нужно убедиться, что установлен пакет именно для архитектуры ucrt64 или mingw64, а не mingw32.
• Несовместимость версий — Lua 5.1, 5.3 и 5.4 существенно различаются синтаксисом и стандартной библиотекой; следует использовать ту версию, которую требует конкретный проект.

¶Использование в IDE

Для разработки на Lua в Windows применяются редакторы с поддержкой подсветки синтаксиса и отладки: VS Code (расширения Lua Language Server, EmmyLua), Sublime Text, Notepad++ с плагином Lua, а также ZeroBrane Studio — специализированная IDE для Lua с встроенным отладчиком и поддержкой удалённого запуска.

¶Источники

• Официальный сайт языка Lua (lua.org)
• Документация MSYS2
• Справочник Chocolatey
• Документация Scoop
• Документация vcpkg