Установка

Выполните одну команду для своей системы и убедитесь, что topaz запускается. Разделы начиная с npm описывают другие способы установки и опубликованные файлы.

Установите одной командой

В macOS и Linux выполните эту команду в терминале.

curl -fsSL https://topaz.ooo/install.sh | sh

В Windows выполните эту команду в PowerShell.

irm https://topaz.ooo/install.ps1 | iex

Скрипт выбирает последний опубликованный выпуск для вашей системы и загружает сжатую программу. Он сверяет загруженный файл и распакованную программу с контрольными суммами SHA-256, опубликованными для этого выпуска. Скрипт помещает topaz в ~/.topaz/bin в macOS и Linux и в %LOCALAPPDATA%\Topaz\bin в Windows.

Проверьте установку

Откройте новый терминал и убедитесь, что он находит команду Топаза.

topaz version

После слова Topaz выводится номер установленной версии. Запишите эту версию при проверке установки или сообщении об ошибке.

Последний опубликованный выпуск имеет номер v5.20.4.

Если команда не найдена, откройте новый терминал и проверьте, есть ли папка установки в PATH. Скрипт для Windows добавляет свою папку в пользовательский PATH. В macOS и Linux скрипт печатает строку export PATH=..., которую нужно добавить, если папки ещё нет в PATH.

Когда topaz version работает, вернитесь к разделу Первая программа, чтобы создать и запустить первый файл.

Начните без установки

В песочнице можно изменять, проверять и запускать код Топаза в браузере без CLI. Песочница загружает WASM компилятора и интерпретатора в Worker. Чтобы вызывать функции Топаза из своего приложения на JavaScript, откройте раздел Вызов функций Топаза из JavaScript.

Установите через npm

Если установлен Node.js 18 или новее, Топаз можно установить через npm. Пакет topaz-lang запускает скрипт установки, который загружает программу для вашей системы и сверяет её с опубликованными контрольными суммами SHA-256.

Установите для всех папок

npm install -g --allow-scripts=topaz-lang topaz-lang
topaz version

--allow-scripts=topaz-lang разрешает npm запускать скрипт установки только пакета topaz-lang. Чтобы установить вместо последнего другой опубликованный выпуск из таблицы ниже, укажите его номер после topaz-lang@.

Установите в одну папку

Чтобы Топаз был только в одной папке проекта, установите его в этой папке и запускайте через npx.

npm install topaz-lang
npx topaz version

Та же команда находится в node_modules/.bin/topaz.

Ответьте на предупреждение о скриптах установки

npm 11 печатает предупреждение npm warn allow-scripts, где названы topaz-lang и его скрипт postinstall. Скрипт установки при этом уже выполнен. Чтобы записать разрешение в package.json этой папки и убрать предупреждение, выполните в ней эту команду.

npm approve-scripts topaz-lang

npm 12 запускает скрипт установки только с вашего разрешения. Если npx topaz version сообщает binary not found, скрипт установки не выполнялся. Разрешите его, как показано выше, и запустите установку снова.

npm rebuild topaz-lang

Загрузите файл напрямую

Для каждого опубликованного выпуска указаны исполняемые файлы, их размер и контрольная сумма SHA-256. Файлы .gz, .xz и .br содержат ту же программу в сжатом виде. Версии ниже соответствуют опубликованным выпускам.

Дата публикации 17 октября 2026 г. · Манифест выпуска

• Все контрольные суммы
• Подпись
• Сведения о подписи
• Открытый ключ

Проверьте файл перед запуском. В Linux выведите его контрольную сумму SHA-256 командой sha256sum.

sha256sum topaz-linux-x86_64

В macOS выполните shasum -a 256 topaz-macos-aarch64 с именем своего файла. В PowerShell в Windows используйте Get-FileHash.

Get-FileHash .\topaz-windows-x86_64.exe -Algorithm SHA256

Значение должно совпадать с SHA-256 этого файла в таблице и со значением в его файле .sha256. PowerShell печатает его заглавными буквами. Сжатый файл требует ещё одного шага. Файл .gz распакуйте командой gzip -d, а файл .xz командой xz -d. Файл .br распакуйте командой brotli -d из инструментов Brotli, а если их нет, загрузите из таблицы несжатый исполняемый файл. Затем сверьте полученную программу с SHA-256 исполняемого файла.

Поместите программу в папку из PATH под именем topaz, а в Windows под именем topaz.exe. В macOS и Linux также сделайте её исполняемой.

mkdir -p ~/.topaz/bin
mv topaz-linux-x86_64 ~/.topaz/bin/topaz
chmod +x ~/.topaz/bin/topaz

Затем проверьте её командой topaz version, как описано выше.

Добавьте инструменты для нативной сборки и Web

Для topaz check и topaz run больше ничего не нужно. Для нативной сборки также нужны Rust и Cargo для целевой платформы. Для сборки Web также нужна цель Rust wasm32-unknown-unknown. Вы воспользуетесь ими в разделе Первое приложение.

Настройте редактор

В VS Code или редакторе с поддержкой Open VSX установите официальное расширение Топаза из Visual Studio Marketplace или Open VSX Registry. Оно распознаёт файлы .tpz, добавляет значок Топаза и подсвечивает синтаксис.

Расширение запускает установленный topaz lsp, чтобы показывать ошибки в редакторе. Компилятор устанавливается отдельно. Убедитесь, что редактор находит его через PATH, или задайте путь в topaz.executablePath. Можно также использовать topaz check в терминале.

Проверьте подпись выпуска

checksums.txt содержит SHA-256 каждого файла выпуска. checksums.txt.sig содержит его подпись Ed25519. Загрузите оба файла и открытый ключ выпуска topaz-release.pub по ссылкам под таблицей файлов, затем проверьте подпись в этой папке с помощью OpenSSL 3.

openssl pkeyutl -verify -pubin -inkey topaz-release.pub -rawin -in checksums.txt -sigfile checksums.txt.sig

OpenSSL печатает Signature Verified Successfully. Манифест выпуска перечисляет все опубликованные файлы выпуска.

Исходный код и лицензии

Выпуск 5.20.4 сохраняет полный исходный код эталонной реализации на Rust под Apache-2.0.

Просмотр исходного кода

Условия использования компонентов и исторический снимок исходного кода описаны на странице Открытые исходники и лицензии.

История выпусков

Выберите опубликованный выпуск, чтобы увидеть его файлы и исходный код.