Установка .NET в Windows
В этой статье вы узнаете, как установить .NET в Windows. .NET состоит из среды выполнения и пакета SDK. Среда выполнения используется для запуска приложения .NET и может не включаться в состав приложения. Пакет SDK используется для создания приложений и библиотек .NET. Среда выполнения .NET всегда устанавливается вместе с пакетом SDK.
Последняя версия .NET — 7.
Существует два типа поддерживаемых выпусков: выпуски с долгосрочной поддержкой (LTS) или стандартная срочная поддержка (STS). Качество всех выпусков одинаковое. Единственное различие заключается в продолжительности поддержки. Выпуски LTS получают бесплатную поддержку и исправления в течение 3 лет. Выпуски STS получают бесплатную поддержку и исправления в течение 18 месяцев. Дополнительные сведения см. в статье Политика поддержки .NET.
В следующей таблице перечислены состояния поддержки каждой версии .NET (и .NET Core):
| ✔️ Поддерживается | ❌ Не поддерживается |
|---|---|
| 7 (STS) | 5 |
| 6 (LTS) | 3.0 |
| 3.1 (LTS) | 2.2 |
| 2.1 | |
| 2,0 | |
| 1,1 | |
| 1.0 |
Установка с Диспетчер пакетов Windows (winget)
Вы можете установить .NET и управлять ими с помощью службы Диспетчер пакетов Windows с помощью средства winget. Дополнительные сведения об установке и использовании winget см.в статье Использование средства winget.
Если вы устанавливаете .NET на уровне системы, установите с правами администратора.
Установка пакета SDK
Пакет SDK для .NET позволяет разрабатывать приложения с помощью .NET. Если вы устанавливаете пакет SDK для .NET, вам не нужно устанавливать соответствующие среды выполнения. Чтобы установить пакет SDK для .NET, выполните приведенную ниже команду.
winget install Microsoft.DotNet.SDK.7
Установка среды выполнения
Для Windows можно установить три среды выполнения .NET. Чтобы обеспечить совместимость со всеми типами приложений .NET, необходимо установить среду выполнения классических приложений .NET и среду выполнения ASP.NET Core.
Среда выполнения классических приложений .NET
Эта среда выполнения включает базовую среду выполнения .NET и поддерживает Windows Presentation Foundation (WPF) и Windows Forms приложения, созданные с помощью .NET. Это не то же самое, что платформа .NET Framework, который поставляется с Windows.
winget install Microsoft.DotNet.DesktopRuntime.7среда выполнения ASP.NET Core
Эта среда выполнения включает базовую среду выполнения .NET и запускает приложения веб-сервера. Среда выполнения ASP.NET Core позволяет запускать приложения, созданные с помощью версии .NET без поддержки среды выполнения. Приведенные ниже команды позволяют установить среду выполнения ASP.NET Core, которая больше всего совместима с .NET. В терминале выполните приведенные ниже команды.
winget install Microsoft.DotNet.AspNetCore.7Среда выполнения .NET
Это базовая среда выполнения, содержащая только компоненты, необходимые для запуска консольного приложения. Как правило, вы устанавливаете другие среды выполнения.
winget install Microsoft.DotNet.Runtime.7
Вы можете установить предварительные версии сред выполнения, заменив номер версии, например 6, словом Preview. В следующем примере устанавливается предварительная версия среды выполнения классических приложений .NET:
winget install Microsoft.DotNet.DesktopRuntime.Preview
Установка вместе с Visual Studio Code
Visual Studio Code — это эффективный и облегченный редактор исходного кода, который работает на компьютере. Visual Studio Code доступен для Windows, macOS и Linux.
Хотя Visual Studio Code не поставляется с автоматическим установщиком .NET Core, таким как Visual Studio, добавление поддержки .NET Core не вызывает затруднений.
- Скачайте и установите Visual Studio Code.
- Скачайте и установите пакет SDK для .NET.
- Установите расширение C# из Marketplace для Visual Studio Code.
Установка с помощью установщика Windows
Страница загрузки для .NET содержит исполняемые файлы установщика Windows.
При использовании установщиков Windows для установки .NET вы можете указать путь установки, задав параметры DOTNETHOME_X64 и DOTNETHOME_X86.
dotnet-sdk-7.0.100-win-x64.exe DOTNETHOME_X64="F:\dotnet\x64" DOTNETHOME_X86="F:\dotnet\x86"
Для установки .NET в автоматическом режиме, например, в рабочей среде, или для поддержки непрерывной интеграции, используйте следующие параметры:
/install
Устанавливает .NET./quiet
Предотвращает отображение любого пользовательского интерфейса и запросов./norestart
Предотвращает все попытки перезапуска.
dotnet-sdk-7.0.100-win-x64.exe /install /quiet /norestart
Дополнительные сведения смотрите в статье Параметры командной строки стандартного установщика.
Совет
В случае успешной установки установщик возвращает код 0; если требуется перезагрузка, установщик возвращает код 3010. Любое другое значение обычно является кодом ошибки.
Установка с помощью функции автоматизации PowerShell
Сценарии dotnet-install используются для автоматизации непрерывной интеграции и ее осуществления без прав администратора. Вы можете скачать сценарий со страницы справочника по сценариям dotnet-install.
Этот скрипт по умолчанию устанавливает последнюю версию с долгосрочной поддержкой (LTS), которой сейчас является .NET 6. Вы можете выбрать конкретный выпуск, указав параметр Channel. Включите параметр Runtime для установки среды выполнения. В противном случае сценарий устанавливает пакет SDK.
Следующая команда устанавливает среду выполнения ASP.NET Core для обеспечения максимальной совместимости. Среда выполнения ASP.NET Core также включает в себя стандартную среду выполнения .NET.
dotnet-install.ps1 -Channel 7.0 -Runtime aspnetcore
Установите пакет SDK, опустив параметр -Runtime. В -Channel этом примере STSзадается параметр , который устанавливает последнюю версию стандартной поддержки терминов (.NET 7).
dotnet-install.ps1 -Channel STS
Установка с помощью Visual Studio
Если вы используете Visual Studio для разработки приложений .NET, в следующей таблице указана минимальная требуемая версия Visual Studio на основе целевой версии пакета SDK для .NET.
| Версия пакета SDK для .NET | Версия Visual Studio |
|---|---|
| 7 | Visual Studio 2022 версии 17.4 или более поздней. |
| 6 | Visual Studio 2022 версии 17.0 или более поздней |
| 5 | Visual Studio 2019 версии 16.8 или более поздней. |
| 3.1 | Visual Studio 2019 версии 16.4 или более поздней. |
| 3.0 | Visual Studio 2019 версии 16.3 или более поздней. |
| 2.2 | Visual Studio 2017 версии 15.9 или более поздней. |
| 2.1 | Visual Studio 2017 версии 15.7 или более поздней. |
Если среда Visual Studio уже установлена, вы можете проверить ее версию, выполнив указанные ниже действия.
- Запустите Visual Studio.
- Выберите Справка>О Microsoft Visual Studio.
- Считайте номер версии из диалогового окна О программе.
Visual Studio может установить последнюю версию пакета SDK для .NET и среды выполнения .NET.
Выбор рабочей нагрузки
При установке или изменении Visual Studio выберите одну или несколько из следующих рабочих нагрузок в зависимости от типа создаваемого приложения:
- рабочая нагрузка Кроссплатформенная разработка .NET Core в разделе Другие наборы инструментов;
- Рабочая нагрузка ASP.NET и веб-разработка в разделе Веб-облако&.
- Рабочая нагрузка разработка Azure в веб-облаке&.
- Рабочая нагрузка разработка классических приложений .NET в разделе Desktop & Mobile .
Поддерживаемые выпуски
В приведенной ниже таблице содержится список поддерживаемых сейчас выпусков .NET и версий Windows, в которых они поддерживаются. Эти версии поддерживаются до окончания поддержки версии .NET, либо до окончания жизненного цикла версии Windows.
Даты окончания жизненного цикла версий Windows 10 зависят от выпуска. В следующей таблице рассматриваются только выпуски Домашняя, Профессиональная, Pro для образовательных учреждений и Pro для рабочих станций. Дополнительные сведения см. в справочных материалах по жизненному циклу поддержки Windows.
Совет
Символ + представляет минимальную версию.
| Операционная система | .NET 7 | .NET 6 | .NET Core 3.1 |
|---|---|---|---|
| Windows 11 | ✔️ | ✔️ | ✔️ |
| Windows Server 2022 | ✔️ | ✔️ | ✔️ |
| Windows Server версии 1903 или более поздней | ✔️ | ✔️ | ✔️ |
| Windows 10 версии 1607 или более поздней | ✔️ | ✔️ | ✔️ |
| Windows 8.1 | ❌ | ✔️ | ✔️ |
| Windows 7 с пакетом обновления 1 (SP1), ESU | ❌ | ✔️ | ✔️ |
| Windows Server 2019 Windows Server 2016 Windows Server 2012 R2 Windows Server 2012 |
✔️ | ✔️ | |
| Windows Server Core 2012 R2 | ✔️ | ✔️ | ✔️ |
| Windows Server Core 2012 | ✔️ | ✔️ | ✔️ |
| Nano Server, версия 1809 и выше | ✔️ | ✔️ | ✔️ |
| Nano Server, версия 1803 | ❌ | ❌ | ✔️ |
Дополнительные сведения о поддерживаемых операционных системах, дистрибутивах и политике жизненного цикла .NET 7 см. в разделе Поддерживаемые версии ОС .NET 7.
Неподдерживаемые выпуски
Следующие версии .NET больше не поддерживаются (❌).
- .NET 5
- .NET Core 3.0
- .NET Core 2.2
- .NET Core 2.1
- .NET Core 2.0;
Сведения о среде выполнения
Среда выполнения используется для запуска приложений, созданных с помощью .NET. При публикации приложения автор может включить среду выполнения в его состав. В противном случае устанавливать среду выполнения будет пользователь.
В Windows можно установить три различные версии среды выполнения:
Среда выполнения ASP.NET Core
Используется для запуска приложений ASP.NET Core. Включает среду выполнения .NET.Среда выполнения для классических приложений
Используется для запуска классических приложений .NET WPF и Windows Forms для Windows. Включает среду выполнения .NET.Среда выполнения .NET
Простейшая среда выполнения, в состав которой не входят какие-либо другие среды выполнения. Чтобы обеспечить максимальный уровень совместимости с приложениями .NET, настоятельно рекомендуется устанавливать среду выполнения ASP.NET Core и среду выполнения для классических приложений.
Сведения о пакете SDK
Пакет SDK используется для создания и публикации приложений и библиотек .NET. При установке пакета SDK также устанавливаются все три среды выполнения: ASP.NET Core, компьютер и .NET.
Компьютеры Windows на базе ARM
В следующих разделах описываются аспекты, которые следует учитывать при установке .NET на компьютере Windows на базе ARM.
Поддерживаемые функции
В следующей таблице описаны версии .NET, поддерживаемые на компьютерах Windows на базе ARM:
| Версия .NET | Architecture | SDK | Параметры выполнения | Конфликт путей |
|---|---|---|---|---|
| 7 | ARM64 | Да | Да | Нет |
| 7 | X64 | Да | Да | Нет |
| 6 | ARM64 | Да | Да | Нет |
| 6 | X64 | Да | Да | Нет |
| 5 | ARM64 | Да | Да | Да |
| 5 | X64 | нет | Да | Да |
| 3.1 | ARM64 | нет | Нет | Н/Д |
| 3.1 | X64 | нет | Да | Да |
Начиная с .NET 6 версии пакета SDK для .NET x64 и Arm64 существуют независимо друг от друга. Если выпущена новая версия, необходимо обновить каждую установку архитектуры.
Различия в путях
На компьютере с Windows под управлением Arm все версии Arm64 .NET устанавливаются в обычную папку C:\Program Files\dotnet\ . Однако при установке 64-разрядной версии пакета SDK для .NET 6 или пакета SDK для .NET 7 она устанавливается в папку C:\Program Files\dotnet\x64\ .
Конфликты путей
Начиная с .NET 6 пакет SDK для .NET для 64-разрядных версий устанавливается в собственный каталог, как описано в предыдущем разделе. Это позволяет использовать версии пакета SDK для .NET для Arm64 и x64 на одном компьютере. Однако любой пакет SDK x64 до 6 не поддерживается и устанавливается в то же расположение, что и версия Arm64, папка C:\Program Files\dotnet\ . Если вы хотите установить неподдерживаемый пакет SDK для x64, сначала необходимо удалить версию для Arm64. Справедливо и обратное — вам нужно удалить неподдерживаемый пакет SDK для x64, чтобы установить версию для Arm64.
Переменные пути
Переменные среды, которые добавляют .NET в системный путь, например PATH переменную , может потребоваться изменить, если у вас установлены версии пакета SDK для .NET x64 и Arm64. Кроме того, некоторые средства используют переменную среды, которую также необходимо обновить, чтобы она указывала на соответствующую папку установки пакета SDK для DOTNET_ROOT .NET.
Зависимости
В .NET 7 поддерживаются следующие версии Windows:
Примечание
Символ + представляет минимальную версию.
| Операционная система | Version | Архитектуры |
|---|---|---|
| Windows 11 | 21H2+ | x64, ARM64 |
| Клиент Windows 10 | 1607+ | x64, x86, ARM64 |
| Клиент Windows | 7 с пакетом обновления 1 и более поздних версий (SP1+), 8.1 | x64, x86 |
| Windows Server | 2012+ | x64, x86 |
| Windows Server Core | 2012+ | x64, x86 |
| Nano Server | 1809+ | X64 |
Дополнительные сведения о поддерживаемых операционных системах, дистрибутивах и политике жизненного цикла .NET 7 см. в разделе Поддерживаемые версии ОС .NET 7.
Windows 7 / Vista / 8.1 / Server 2008 R2 / Server 2012 R2
При установке пакета SDK для .NET или среды выполнения .NET в следующих версиях Windows требуются дополнительные зависимости:
| Операционная система | Предварительные требования |
|---|---|
| Windows 7 с пакетом обновления 1 (SP1), ESU | – Распространяемый компонент Microsoft Visual C++ 2015–2019, 64-разрядный / 32-разрядный – Обновление KB3063858, 64-разрядное / 32-разрядное - Центр корневой сертификации Microsoft 2011 (только удаленный установщик .NET Core 2.1) |
| Windows Vista с пакетом обновления 2 (SP2) | Распространяемый компонент Microsoft Visual C++ 2015–2019, 64-разрядный / 32-разрядный |
| Windows 8.1 | Распространяемый компонент Microsoft Visual C++ 2015–2019, 64-разрядный / 32-разрядный |
| Windows Server 2008 R2 | Распространяемый компонент Microsoft Visual C++ 2015–2019, 64-разрядный / 32-разрядный |
| Windows Server 2012 | Распространяемый компонент Microsoft Visual C++ 2015–2019, 64-разрядный / 32-разрядный |
| Windows Server 2012 R2 | Распространяемый компонент Microsoft Visual C++ 2015–2019, 64-разрядный / 32-разрядный |
Приведенные выше требования также применяются, если возникает ошибка, связанная с любой из следующих библиотек DLL:
- api-ms-win-crt-runtime-l1-1-0.dll
- api-ms-win-cor-timezone-l1-1-0.dll
- hostfxr.dll
Docker
Контейнеры обеспечивают простой способ изоляции приложения от остальной части основной системы. Контейнеры на одном компьютере совместно использую только ядро, а также используют ресурсы, которые передаются в приложение.
.NET можно выполнять в контейнере Docker. Официальные образы Docker для .NET публикуются в реестре контейнеров Microsoft (MCR), и доступ к ним можно получить в репозитории Microsoft .NET Docker Hub. Каждый репозиторий содержит рабочие образы для разных сочетаний .NET (пакета SDK или среды выполнения) и операционной системы.
Корпорация Майкрософт предоставляет образы, которые предназначены для конкретных сценариев. Например репозиторий ASP.NET Core содержит образы, которые предназначены для запуска приложений ASP.NET Core в рабочей среде.
Дополнительные сведения об использовании .NET в контейнере Docker см. в статьях Введение в .NET и Docker и Примеры.
Устранение неполадок
После установки пакета SDK для .NET могут возникнуть проблемы с выполнением команд .NET CLI. В этом разделе собраны эти распространенные проблемы и приводятся решения.
Не удалось найти установленные пакеты SDK для .NET Core
Скорее всего, вы установили 32-разрядную (32-разрядную) и 64-разрядную версии пакета SDK для .NET. Это приводит к конфликту, так как при выполнении dotnet команды она разрешается в версию x86, когда она должна разрешаться в версию x64. Обычно это устраняется путем настройки переменной %PATH% , чтобы сначала разрешить версию x64.
Убедитесь, что установлены обе версии, выполнив
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\ в первую очередь, у вас нет проблемы, обсуждаемой в этом разделе, и вы должны создать проблему с запросом справки .NET на GitHub
Нажмите кнопку Windows и введите "Изменить системные переменные среды" для поиска. Выберите Изменить системные переменные среды.
Откроется окно Свойства системы на вкладке Дополнительно. Выберите Переменные среды.
В окне Переменные среды в группе Системные переменные выберите строку Путь*, а затем нажмите кнопку Изменить .
Используйте кнопки Вверх и Переместить вниз , чтобы переместить запись C:\Program Files\dotnet\ над C:\Program Files (x86)\dotnet\.
