Установка .NET в Windows

В этой статье описывается, какие версии .NET поддерживаются в Windows, как установить .NET, а также о различиях между пакетом SDK и средой выполнения.

В отличие от платформа .NET Framework, .NET не привязан к вашей версии Windows. В Windows можно установить только одну версию платформа .NET Framework. Но .NET является автономным и может быть установлен в любом месте на компьютере. Некоторые приложения могут включать собственную копию .NET.

По умолчанию .NET устанавливается в каталог Program Files\dotnet на компьютере, если метод установки не выбирает другой каталог.

.NET состоит из среды выполнения и пакета SDK. Среда выполнения запускает приложения .NET, а пакет SDK используется для создания приложений.

Выбор правильной среды выполнения

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

Чтобы обеспечить запуск всех приложений .NET в Windows, установите как среду выполнения ASP.NET Core, так и среду выполнения .NET Desktop. Среда выполнения ASP.NET Core запускает веб-приложения, а среда выполнения рабочего стола .NET запускает классические приложения, такие как приложение Windows Presentation Foundation (WPF) или Windows Forms.

Выбор способа установки .NET

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

Если вы не уверены, какой метод следует выбрать после просмотра списков в следующих разделах, вы, вероятно, хотите использовать установщик .NET.

Разработчикам

• Visual Studio

  Используйте Visual Studio для установки .NET, если вы хотите разрабатывать приложения .NET с помощью Visual Studio. Visual Studio управляет собственной копией .NET. Этот метод устанавливает шаблоны SDK, среды выполнения и Visual Studio.

• Visual Studio Code — комплект средств разработки на C#

  Установите расширение Dev Kit C# для Visual Studio Code, чтобы разрабатывать приложения .NET. Расширение может использовать пакет SDK, который уже установлен или установить его для вас.

Пользователи и разработчики

• Установщик .NET

  Установите .NET с помощью пакета установщика Windows, представляющего собой исполняемый файл. Этот метод может установить пакет SDK и среду выполнения. Установка выполняется на уровне системы.

• Диспетчер пакетов Windows (WinGet)

  Используйте WinGet для установки .NET, если вы хотите управлять .NET через командную строку. Этот метод может установить пакет SDK и среду выполнения. Установка выполняется на уровне системы.

• PowerShell

  Скрипт PowerShell, который может автоматизировать установку пакета SDK или среды выполнения. Вы можете выбрать версию .NET для установки.

Поддерживаемые версии

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

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

Windows 7 / 8.1 / Server 2012

Версия .NET больше не поддерживается в Windows 7 и Windows 8.1. Последние поддерживаемые выпуски — .NET 6 и поддержка закончилась 12 ноября 2024 г.

Windows Server 2012 по-прежнему поддерживается любой версией .NET, которая по-прежнему поддерживается.

Все три из этих версий Windows требуют установки дополнительных зависимостей:

Приведенные выше требования также применяются, если возникает ошибка, связанная с любой из следующих библиотек DLL:

• api-ms-win-crt-runtime-l1-1-0.dll
• api-ms-win-cor-timezone-l1-1-0.dll
• hostfxr.dll

Компьютеры Windows на базе ARM

.NET поддерживается на компьютерах с Windows на основе Arm. В следующих разделах описаны вещи, которые следует учитывать при установке .NET.

Различия в путях

На компьютере с Windows на основе Arm все версии Arm64 .NET устанавливаются в обычную папку C:\Program Files\dotnet\. Однако x64 версия пакета SDK для .NET установлена в папку C:\Program Files\dotnet\x64\.

Переменные пути

Переменные среды, которые добавляют .NET в системный путь, такие как переменная PATH, возможно, потребуется изменить, если у вас установлены обе версии пакета SDK для .NET: для x64 и Arm64. Кроме того, некоторые средства полагаются на DOTNET_ROOT переменную среды, которая также должна быть обновлена, чтобы указать соответствующую папку установки пакета SDK для .NET.

Установка с помощью Visual Studio

Visual Studio устанавливает собственную копию .NET отдельно от других копий .NET. Разные версии Visual Studio поддерживают разные версии .NET. Последняя версия Visual Studio всегда поддерживает последнюю версию .NET.

Visual Studio Installer устанавливает и настраивает Visual Studio. Некоторые рабочие нагрузки Visual Studio включают .NET, такие как ASP.NET и веб-разработка и разработка многоплатформенного пользовательского интерфейса приложений .NET. Определенные версии .NET можно установить на вкладке "Отдельные компоненты ".

Документация по Visual Studio предоставляет инструкции о том, как:

• Установите Visual Studio.
• Настройка рабочих нагрузок Visual Studio.

Версии .NET и Visual Studio

Если вы используете Visual Studio для разработки приложений .NET, в следующей таблице указана минимальная требуемая версия Visual Studio на основе целевой версии пакета SDK для .NET.

Если среда Visual Studio уже установлена, вы можете проверить ее версию, выполнив указанные ниже действия.

1. Откройте Visual Studio.
2. Выберите Справка>О Microsoft Visual Studio.
3. Считайте номер версии из диалогового окна О программе.

Для получения дополнительной информации см. статью о версиях SDK для .NET, MSBuild и Visual Studio.

Установка с помощью Visual Studio Code

Visual Studio Code — это эффективный и облегченный редактор исходного кода, который работает на компьютере. Visual Studio Code может использовать пакет SDK, уже установленный в вашей системе.

Этот файл конфигурации WinGet устанавливает последнюю версию .NET SDK, Visual Studio Code и C# DevKit. Если у вас уже есть один из них, WinGet пропустит этот шаг.

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

Кроме того, расширение C# Dev Kit установит для вас .NET, если он еще не установлен.

Инструкции по установке .NET с помощью Visual Studio Code см. в статье "Начало работы с C# в VS Code".

Установщик .NET

Страница загрузки для .NET содержит исполняемые файлы установщика Windows.

1. Откройте веб-браузер и перейдите к https://dotnethttps://dotnet.microsoft.com/download/dotnet.

2. Выберите версию .NET, которую вы хотите скачать, например 9.0.

3. Найдите пакет SDK или поле среды выполнения, содержащее ссылки для скачивания .NET.

4. В столбце установщиков найдите строку Windows и выберите ссылку для архитектуры ЦП. Если вы не уверены, выберите x64 , так как это наиболее распространено.

   Браузер должен автоматически скачать установщик.

   Совет

   На следующем рисунке показан пакет SDK, но вы также можете скачать среду выполнения.

   

5. Откройте проводник Windows и перейдите к месту скачивания файла, скорее всего, папку downloads .

6. Дважды щелкните файл, чтобы установить .NET.

   Откроется диалоговое окно установщика Windows.

   

7. Выберите " Установить " и следуйте инструкциям по установке .NET.

Чтобы узнать, как использовать .NET CLI, см. обзор .NET CLI.

Параметры командной строки

/? Используйте параметр для отображения списка параметров.

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

• /install
  Устанавливает .NET.

• /quiet
  Предотвращает отображение любого пользовательского интерфейса и запросов.

• /norestart
  Подавляет попытки перезапуска.

dotnet-sdk-9.0.100-win-x64.exe /install /quiet /norestart

Если вы уже установили .NET, используйте установщик .NET для управления установкой. Вместо /installиспользуйте один из следующих вариантов:

• /uninstall
  Удалите эту версию .NET.

• /repair
  Проверьте, повреждены ли ключевые файлы или компоненты установки, и восстановите их.

Центр обновления Майкрософт

Исполняемые файлы установщика .NET — это независимые продукты, которые можно обновлять через Microsoft Update на Windows. MU отличается от Обновления Windows (WU), который используется для обслуживания компонентов операционной системы, таких как платформа .NET Framework.

Исправления как для безопасности, так и не связанные с безопасностью для поддерживаемых версий .NET предоставляются через Microsoft Update с использованием нескольких каналов распространения. Автоматическое обновление (AU) предназначено для конечных пользователей и потребителей, а службы обновлений Windows Server (WSUS) и каталог обновлений Windows — для ИТ-администраторов.

Исполняемые файлы установщика .NET поддерживают параллельные установки (SxS) в основных и дополнительных версиях для различных архитектур и компонентов, таких как среда выполнения и SDK. Например, можно установить среду выполнения 6.0.15 (x64) и 6.0.17 (x86). При активации MU он будет предоставлять новейший установщик для обеих установок.

Блокировка обновлений

Хотя большинство пользователей предпочитают быть в курсе, можно заблокировать обновления .NET с помощью ключей реестра в следующей таблице.

Автоматическое обновление для ОС сервера

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

Выбор момента удаления предыдущих версий

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

• never сохраняет предыдущие установки и требует ручного вмешательства для удаления предыдущих установок .NET.
• always Удаляет предыдущие установки после установки новой версии. Это поведение по умолчанию в .NET.
• nextSession Откладывает удаление до следующего сеанса входа для пользователей из группы "Администраторы".
• Значения не чувствительны к регистру, а недопустимые значения по умолчанию устанавливаются в always.

При отсрочке удаления установщик записывает команду в раздел реестра RunOnce для удаления предыдущей версии. Команда выполняется только в том случае, если пользователь в группе "Администраторы" входит на компьютер.

Установка с использованием диспетчера пакетов Windows (WinGet)

Вы можете установить и управлять .NET через службу Диспетчера пакетов Windows с помощью winget.exe средства. Дополнительные сведения об установке и использовании WinGet см. в статье "Использование средства winget для установки приложений и управления ими".

Если вы устанавливаете .NET на уровне системы, установите с правами администратора.

Пакеты WinGet для .NET:

• Microsoft.DotNet.Runtime.9—.NET Runtime 9.0
• Microsoft.DotNet.AspNetCore.9—ASP.NET Core Runtime 9.0
• Microsoft.DotNet.DesktopRuntime.9—Среда выполнения рабочего стола .NET 9.0
• Microsoft.DotNet.SDK.9—Пакет SDK .NET 9.0
• Microsoft.DotNet.Runtime.8—.NET Runtime 8.0
• Microsoft.DotNet.AspNetCore.8— ASP.NET Core Runtime 8.0
• Microsoft.DotNet.DesktopRuntime.8—.NET Desktop Runtime 8.0
• Microsoft.DotNet.SDK.8— пакет SDK для .NET 8.0

Установка пакета SDK

Если установить пакет SDK, вам не нужно устанавливать соответствующую среду выполнения.

1. Установите WinGet.

2. Откройте терминал, например PowerShell или командную строку.

3. winget install Выполните команду и передайте имя пакета SDK:

   winget install Microsoft.DotNet.SDK.9
   

Чтобы узнать, как использовать .NET CLI, см. обзор .NET CLI.

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

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

1. Установите WinGet.

2. Откройте терминал, например PowerShell или командную строку.

3. winget install Выполните команду и передайте имя пакета SDK:

   winget install Microsoft.DotNet.DesktopRuntime.9
   winget install Microsoft.DotNet.AspNetCore.9
   

Чтобы узнать, как использовать .NET CLI, см. обзор .NET CLI.

Поиск версий

winget search Используйте команду для поиска различных версий пакета, который требуется установить. Например, следующая команда выполняет поиск всех пакетов SDK для .NET, доступных через WinGet:

winget search Microsoft.DotNet.SDK

Результаты поиска печатаются в таблице с каждым идентификатором пакета.

Name                           Id                           Version                    Source
----------------------------------------------------------------------------------------------
Microsoft .NET SDK 9.0         Microsoft.DotNet.SDK.9       9.0.100                    winget
Microsoft .NET SDK 8.0         Microsoft.DotNet.SDK.8       8.0.300                    winget
Microsoft .NET SDK 7.0         Microsoft.DotNet.SDK.7       7.0.409                    winget
Microsoft .NET SDK 6.0         Microsoft.DotNet.SDK.6       6.0.422                    winget
Microsoft .NET SDK 5.0         Microsoft.DotNet.SDK.5       5.0.408                    winget
Microsoft .NET SDK 3.1         Microsoft.DotNet.SDK.3_1     3.1.426                    winget

Установка предварительных версий

Если доступна предварительная версия, замените номер версии в идентификаторе словом Preview. В следующем примере устанавливается предварительная версия среды выполнения рабочего стола .NET:

winget install Microsoft.DotNet.DesktopRuntime.Preview

Установка с помощью PowerShell

Установка .NET с помощью скрипта PowerShell рекомендуется для непрерывной интеграции и установок без прав администратора. Если вы устанавливаете .NET для нормального использования в системе, используйте установщик .NET или методы установки Диспетчер пакетов Windows.

Сценарий по умолчанию используется для установки последней долгосрочной версии поддержки (LTS), которая является .NET 8. Вы можете выбрать конкретный выпуск, указав переключатель -Channel. Включите флаг -Runtime, чтобы установить среду выполнения. В противном случае сценарий устанавливает пакет SDK. Скрипт доступен https://dot.net/v1/dotnet-install.ps1 в GitHub, а исходный код размещен на сайте GitHub.

Чтобы получить дополнительные сведения о скрипте, см. dotnet— справка по установке скрипта.

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

Среда выполнения .NET устанавливается путем предоставления коммутатора -Runtime .

1. Скачивание скрипта установки из https://dot.net/v1/dotnet-install.ps1

2. Откройте PowerShell и перейдите в папку, содержащую скрипт.

3. Выполните следующие команды, чтобы установить среду выполнения desktop и ASP.NET Core для обеспечения максимальной совместимости:

   dotnet-install.ps1 -Runtime windowsdesktop
   dotnet-install.ps1 -Runtime aspnetcore
   

Чтобы узнать, как использовать .NET CLI, см. обзор .NET CLI.

Установка пакета SDK

Если установить пакет SDK, вам не нужно устанавливать среды выполнения.

1. Скачивание скрипта установки из https://dot.net/v1/dotnet-install.ps1

2. Откройте PowerShell и перейдите в папку, содержащую скрипт.

3. Выполните следующую команду, чтобы установить пакет SDK для .NET.

   dotnet-install.ps1
   

   Примечание.

   Пакет SDK устанавливается путем пропуска -Runtime переключателя.

Чтобы узнать, как использовать .NET CLI, см. обзор .NET CLI.

Проверка

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

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

Вы можете использовать PowerShell или командную строку для проверки контрольной суммы загруженного файла. Например, следующая команда сообщает контрольную сумму файла dotnet-sdk-8.0.100-win-x64.exe:

> certutil -hashfile dotnet-sdk-8.0.100-win-x64.exe SHA512
SHA512 hash of dotnet-sdk-8.0.100-win-x64.exe:
248acec95b381e5302255310fb9396267fd74a4a2dc2c3a5989031969cb31f8270cbd14bda1bc0352ac90f8138bddad1a58e4af1e56cc4a1613b1cf2854b518e
CertUtil: -hashfile command completed successfully.

> (Get-FileHash .\dotnet-sdk-8.0.100-win-x64.exe -Algorithm SHA512).Hash
248acec95b381e5302255310fb9396267fd74a4a2dc2c3a5989031969cb31f8270cbd14bda1bc0352ac90f8138bddad1a58e4af1e56cc4a1613b1cf2854b518e

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

Использование PowerShell и файла контрольной суммы для проверки

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

1. Страница заметок о выпуске для .NET 8 на сайте GitHub https://github.com/dotnet/core/tree/main/release-notes/8.0 содержит раздел с именем "Выпуски". Таблица в этом разделе содержит ссылки на файлы загрузки и контрольные суммы для каждого выпуска .NET 8.

   

2. Выберите ссылку для скачаемой версии .NET. Предыдущий раздел использовал пакет SDK для .NET 8.0.100, который находится в выпуске .NET 8.0.0.

   Совет

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

3. На странице выпуска можно увидеть версию среды выполнения .NET и пакета SDK для .NET, и ссылку на файл контрольной суммы.

   

4. Скопируйте ссылку на файл контрольной суммы.

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

   Invoke-WebRequest https://builds.dotnet.microsoft.com/dotnet/checksums/8.0.0-sha.txt -OutFile 8.0.0-sha.txt
   

6. При условии, что оба файла - контрольной суммы и выпуска .NET - загружены в одну и ту же директорию, найдите в файле контрольной суммы контрольную сумму загрузки .NET.

   При прохождении проверки отображается значение True :

   > (Get-Content .\8.0.0-sha.txt | Select-String "dotnet-sdk-8.0.100-win-x64.exe").Line -like (Get-FileHash .\dotnet-sdk-8.0.100-win-x64.exe -Algorithm SHA512).Hash + "*"
   True
   

   Если отображается False, скачанный файл не является действительным и не должен использоваться.

Устранение неполадок

После установки пакета SDK для .NET могут возникнуть проблемы, связанные с выполнением команд .NET CLI. В этом разделе собираются распространенные проблемы и предоставляются решения.

• Пакет SDK для .NET не найден
• Создание приложений медленнее, чем ожидалось
• hostfxr.dll / api-ms-win-crt-runtime-l1-1-0.dll / api-ms-win-cor-timezone-l1-1-0.dll отсутствует

Пакет SDK для .NET не найден

Скорее всего, вы установили версии x86 (32-разрядная версия) и x64 (64-разрядная версия пакета SDK для .NET). Это приводит к конфликту, так как при выполнении dotnet команды она разрешается в версию x86, когда она должна разрешаться в версию x64. Эта проблема устранена путем настройки переменной %PATH% , чтобы сначала устранить версию x64.

1. Убедитесь, что установлены обе версии, выполнив where.exe dotnet команду. Если это сделать, вы увидите запись для папок Program Files\ и Program Files (x86)\. Если папка Program Files (x86)\ первой, как показано в следующем примере, это неправильно, и вы должны перейти к следующему шагу.

   > where.exe dotnet
   C:\Program Files (x86)\dotnet\dotnet.exe
   C:\Program Files\dotnet\dotnet.exe
   

   Совет

   Несмотря на то, что в этом примере используется Program Files, в списке могут отображаться другие копии dotnet.exe. Настройте их таким образом, чтобы соответствующая dotnet.exe сначала распознавалась.

   Если это верно и Program Files\ стоит первым, у вас нет проблемы, которую обсуждает этот раздел, и вы должны создать запрос помощи .NET на GitHub.

2. Нажмите кнопку Windows и введите "Изменить системные переменные среды" в поиск. Выберите "Изменить системные переменные среды".

   

3. Откроется окно "Свойства системы" на вкладке "Дополнительно". Выберите переменные среды.

   

4. В окне "Переменные среды" в группе системных переменных выберите строку Path* и нажмите кнопку "Изменить".

   

5. Используйте кнопки 'Вверх' и 'Вниз', чтобы переместить запись C:\Program Files\dotnet\ выше C:\Program Files (x86)\dotnet\.

   

Создание приложений медленнее, чем ожидалось

Убедитесь, что smart App Control, компонент Windows, отключен. Функция интеллектуального управления приложениями не рекомендуется для включения на компьютерах, используемых для разработки. Любой параметр, отличный от "off", может отрицательно повлиять на производительность пакета SDK.

hostfxr.dll / api-ms-win-crt-runtime-l1-1-0.dll / api-ms-win-cor-timezone-l1-1-0.dll отсутствует

Установите распространяемый компонент Microsoft Visual C++ 2015-2019 (64-разрядная или 32-разрядная версия).

Связанный контент

• Обзор интерфейса командной строки .NET
• Обновление до новой версии .NET.
• Проверка того, установлена ли платформа .NET.
• Руководство: учебник Hello World.
• Руководство. Создание приложения с помощью Visual Studio Code.