Початок Роботи
- Реліз із тегами чи нічна збірка?
- Встановлення Zig
-
Пряме завантаження
- Налаштування PATH у Windows
- Налаштування PATH на Linux, macOS, BSD
- Менеджери пакетів
- Windows
- macOS
- Linux
- Зібрати з вихідного коду
-
Пряме завантаження
- Рекомендовані інструменти
- Підсвітка синтаксису та LSP
- Запустіть Hello World
- Наступні кроки
Реліз із тегами чи нічна збірка?
Zig ще не досяг версії 1.0, і поточний цикл випуску прив’язаний до нових випусків LLVM, які відбуваються приблизно раз на 6 місяців. З практичної точки зору, Випуски Zig, як правило, знаходяться далеко одна від одної та з часом стають застарілими, враховуючи поточну швидкість розробки.
Добре оцінювати Zig за допомогою версії з тегами, але якщо ви вирішите, що вам подобається Zig і хочете зануритися глибше, ми радимо вам перейти на нічну збірку, головним чином тому, що таким чином вам буде легше отримати допомогу: більшість спільнот і сайтів таких як zig.guide відстежують головну гілку з причин, зазначених вище.
Хороша новина полягає в тому, що дуже легко переходити з однієї версії Zig на іншу або навіть мати кілька версій, присутніх у системі одночасно: випуски Zig — це самодостатні архіви, які можна розмістити будь-де у вашій системі.
Встановлення Zig
Пряме завантаження
Це найпростіший спосіб отримати Zig: візьміть пакет Zig для вашої платформи зі сторінки Завантаження, витягніть його в каталог і додайте до свого PATH
, щоб мати можливість викликати zig
з будь-якого місця.
Налаштування PATH у Windows
Щоб налаштувати шлях у Windows, запустіть один із наведених нижче фрагментів коду в Powershell. Оберіть, чи хочете ви застосувати цю зміну на загальносистемному рівні (потрібно запустити Powershell з правами адміністратора) або лише для вашого користувача, і переконайтесь, що фрагмент коду вказує на місце, де лежить ваша копія Zig. ;
перед C:
не є опечаткою.
По всій системі (Powershell з правами адміністратора):
[Environment]::SetEnvironmentVariable(
"Path",
[Environment]::GetEnvironmentVariable("Path", "Machine") + ";C:\your-path\zig-windows-x86_64-your-version",
"Machine"
)
На рівню одного користувача (Powershell):
[Environment]::SetEnvironmentVariable(
"Path",
[Environment]::GetEnvironmentVariable("Path", "User") + ";C:\your-path\zig-windows-x86_64-your-version",
"User"
)
Після завершення перезапустіть Powershell.
Налаштування PATH на Linux, macOS, BSD
Додайте розташування вашого двійкового файлу zig до змінної середовища PATH.
Зазвичай це робиться шляхом додавання рядка експорту до сценарію запуску оболонки (.profile
, .zshrc
, ...)
export PATH=$PATH:~/path/to/zig
Після того, як ви закінчите, або source
файл запуску, або перезапустіть оболонку.
Менеджери пакетів
Windows
WinGet
Zig доступний на WinGet.
winget install -e --id zig.zig
Chocolatey
Zig доступний на Chocolatey.
choco install zig
Scoop
Zig доступний на Scoop.
scoop install zig
Latest dev build:
scoop bucket add versions
scoop install versions/zig-dev
macOS
Homebrew
Реліз з останнім тегом
brew install zig
MacPorts
port install zig
Linux
Zig також присутній у багатьох менеджерах пакетів для Linux. Тут ви можете знайти оновлений список, але майте на увазі, що деякі пакунки можуть містити застарілі версії Zig.
Зібрати з вихідного коду
Тут ви можете знайти більше інформації про те, як зібрати Zig з вихідного коду для Linux, macOS і Windows.
Рекомендовані інструменти
Підсвітка синтаксису та LSP
Усі основні текстові редактори підтримують підсвічування синтаксису для Zig. Деякі комплектують його, інші вимагають встановлення плагіна.
Якщо ви зацікавлені в глибшій інтеграції між Zig і вашим редактором, зверніть увагу на zigtools/zls.
Якщо вас цікавить, що ще доступно, відвідайте секціюІнструменти.
Запустіть Hello World
Якщо ви правильно завершили процес інсталяції, тепер ви зможете викликати компілятор Zig зі своєї оболонки. Давайте перевіримо це, створивши вашу першу програму Zig!
Перейдіть до каталогу ваших проектів і запустіть:
mkdir hello-world
cd hello-world
zig init
Це має вивести:
info: created build.zig
info: created build.zig.zon
info: created src/main.zig
info: created src/root.zig
info: see `zig build --help` for a menu of options
Запуск zig build run
повинен потім скомпілювати виконуваний файл і запустити його, в результаті чого:
All your codebase are belong to us.
Run `zig build test` to run the tests.
Вітаємо, Ви успішно встановили Zig!
Наступні кроки
Перегляньте інші ресурси, представлені в секції Вчитися, переконайтеся, що знайшли документацію для вашої версії Zig (примітка: для нічних збірок слід використовувати документації з тегом master
) подумайте про те, щоб прочитати zig.guide.
Zig — це молодий проект, і, на жаль, у нас ще немає можливостей для створення великої документації та навчання матеріалів для всього, тому ви повинні розглянути вступ до однієї зі спільнот Zig щоб отримати допомогу, коли ви застрягли, а також звернути увагу на такі ініціативи як Zig SHOWTIME.
Нарешті, якщо вам подобається Zig і ви хочете допомогти пришвидшити розробку, подумайте про пожертвування Zig Software Foundation .