deno install

deno install устанавливает зависимости и кеширует их для вашего проекта. Подробнее о том, как Deno обрабатывает модули, см. в разделе Модули и зависимости.

Примеры

deno install

Используйте эту команду, чтобы установить все зависимости, определённые в deno.json и/или package.json.

Зависимости будут установлены в глобальный кеш, но если в вашем проекте есть файл package.json, будет также создан локальный каталог node_modules.

deno install [PACKAGES]

Используйте эту команду, чтобы установить определённые пакеты и добавить их в deno.json или package.json.

deno install jsr:@std/testing npm:express

Если в вашем проекте есть файл package.json, пакеты из npm будут добавлены в dependencies в package.json. В противном случае все пакеты будут добавлены в deno.json.

deno install --os и --arch

Начиная с Deno 2.8, deno install принимает флаги --os и --arch, позволяющие устанавливать npm-пакеты для платформы, отличной от той, на которой выполняется команда. Это особенно полезно для предварительной установки пакетов с нативными бинарными файлами — например, при сборке артефакта для развёртывания на компьютере разработчика с macOS, если впоследствии он будет работать на Linux/arm64.

Флаги принимают значения, совместимые с Node.js, — те же строки, которые возвращают process.platform и process.arch.

# Install npm packages for linux/arm64
deno install --os linux --arch arm64

# Install for windows/x64
deno install --os win32 --arch x64

# Override just the architecture; --os defaults to the current system
deno install --arch x64

--os и --arch работают только при локальной установке и несовместимы с --global.

deno install --package-json

По умолчанию Deno выбирает файл конфигурации для записи (deno.json или package.json) в зависимости от того, какой из них находится ближе всего к текущему рабочему каталогу. Начиная с Deno 2.8, --package-json принудительно записывает зависимости в package.json независимо от наличия поблизости deno.json. Если файла package.json ещё нет, он будет создан.

deno install --package-json npm:express jsr:@std/path

Пакеты JSR, добавленные с помощью --package-json, записываются в совместимом с npm формате (npm:@jsr/...). Этот же флаг работает с deno add, deno remove и deno uninstall.

Чтобы использовать это поведение по умолчанию, не указывая флаг каждый раз, задайте "preferPackageJson": true в deno.json.

deno install --entrypoint [FILES]

Используйте эту команду, чтобы установить все зависимости, используемые в указанных файлах, а также зависимости этих зависимостей.

Это особенно полезно, если в коде используются спецификаторы jsr:, npm:, http: или https: и нужно кешировать все зависимости до развёртывания проекта.

import * as colors from "jsr:@std/fmt/colors";
import express from "npm:express";

deno install -e main.js
Download jsr:@std/fmt
Download npm:express

deno install --global [PACKAGE_OR_URL]

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

Эта команда создаёт небольшой исполняемый сценарий оболочки, который запускает deno с указанными флагами CLI и главным модулем. Он размещается в корневом каталоге установки.

Пример:

deno install --global --allow-net --allow-read jsr:@std/http/file-server
Download jsr:@std/http/file-server...

✅ Successfully installed file-server.
/Users/deno/.deno/bin/file-server

Чтобы изменить имя исполняемого файла, используйте -n/--name:

deno install -g -N -R -n serve jsr:@std/http/file-server

По умолчанию имя исполняемого файла определяется автоматически:

• Используется имя файла без расширения из пути URL. В приведённом выше примере получится 'file-server'.
• Если имя файла без расширения является общим, например 'main', 'mod', 'index' или 'cli', а у пути нет родительского каталога, используется имя файла из родительского пути. В противном случае сохраняется общее имя.
• Если в итоговом имени есть суффикс '@...', он удаляется.

Чтобы изменить корневой каталог установки, используйте --root:

deno install -g -N -R --root /usr/local/bin jsr:@std/http/file-server

Корневой каталог установки определяется в следующем порядке приоритета:

• Параметр --root
• Переменная среды DENO_INSTALL_ROOT
• $HOME/.deno

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

echo 'export PATH="$HOME/.deno/bin:$PATH"' >> ~/.bashrc

При установке необходимо указать разрешения, с которыми будет запускаться скрипт.

deno install -g -N -R jsr:@std/http/file-server -- -p 8080

Приведённая выше команда создаёт исполняемый файл file_server, который запускается с разрешениями на доступ к сети и чтение и привязывается к порту 8080.

Для соблюдения рекомендаций используйте идиому import.meta.main, чтобы указать точку входа в исполняемом скрипте.

Пример:

// https://example.com/awesome/cli.ts
async function myAwesomeCli(): Promise<void> {
  // -- snip --
}

if (import.meta.main) {
  myAwesomeCli();
}

Создавая исполняемый скрипт, обязательно сообщите об этом пользователям: добавьте в репозиторий пример команды для установки.

# Install using deno install

deno install -n awesome_cli https://example.com/awesome/cli.ts

deno install --global --compile [PACKAGE_OR_URL]

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

deno install --global --compile -A npm:@anthropic-ai/claude-code

Эта команда объединяет поведение deno compile с глобальной установкой — создаёт нативный бинарный файл в корневом каталоге установки (как --global, но без --compile).

deno install --prod

Используйте эту команду, чтобы установить только производственные зависимости, пропуская devDependencies из package.json.

deno install --prod

Это полезно при развёртывании приложения, которому не нужны зависимости для разработки, например тестовые фреймворки или инструменты сборки.

Флаг --prod несовместим с --global и --dev.

В средах CI предпочтительнее использовать deno ci --prod: эта команда также обеспечивает неизменность файла блокировки и удаляет все ранее существовавшие node_modules перед установкой.

--skip-types

В сочетании с --prod флаг --skip-types также пропускает пакеты @types/* как среди зависимостей package.json, так и среди импортов deno.json:

deno install --prod --skip-types

--prod с --entrypoint

При сочетании --prod с --entrypoint граф модулей строится только по коду, без зависимостей, содержащих только типы:

deno install --prod --entrypoint main.ts

Это обеспечивает наиболее точную установку для производственной среды: будут установлены только зависимости, действительно импортируемые во время выполнения указанной точкой входа и её транзитивными импортами.

Нативные дополнения Node.js

Многие популярные npm-пакеты, например npm:sqlite3 или npm:duckdb, используют «скрипты жизненного цикла», например скрипты preinstall или postinstall. Чаще всего выполнение этих скриптов необходимо для корректной работы пакета.

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

Эти скрипты всё же можно запустить, передав флаг --allow-scripts=<packages> при выполнении deno install:

deno install --allow-scripts=npm:sqlite3

Установить все зависимости и разрешить пакету npm:sqlite3 выполнять скрипты жизненного цикла.

Флаг --quiet

Флаг --quiet подавляет диагностические сообщения при установке зависимостей. При использовании вместе с deno install он скрывает индикаторы выполнения, сведения о загрузках и сообщения об успешном завершении.

deno install --quiet jsr:@std/http/file-server

Это полезно в сценариях автоматизации или когда нужно, чтобы вывод в конвейерах CI был более лаконичным.

Удаление

Удалить зависимости или бинарный скрипт можно командой deno uninstall:

deno uninstall express
Removed express

deno uninstall -g file-server
deleted /Users/deno/.deno/bin/file-server
✅ Successfully uninstalled file-server

Дополнительные сведения см. на странице deno uninstall.