macOS에 .NET 설치

이 문서에서는 macOS에서 지원되는 .NET 버전, .NET 설치하는 방법 및 SDK와 런타임 간의 차이점을 설명합니다.

.NET 최신 버전은 10입니다.

지원되는 버전

다음 표에서는 지원되는 .NET 릴리스와 지원되는 macOS를 나열합니다. 이러한 버전은 .NET 버전이 지원 종료 또는 macOS 버전이 더 이상 지원되지 않을 때까지 계속 지원됩니다.

macOS 버전	.NET
macOS 26 "Tahoe"	10.0, 9.0, 8.0
macOS 15 "Sequoia"	10.0, 9.0, 8.0
macOS 14 "Sonoma"	9.0, 8.0

다음 버전의 .NET ❌ 더 이상 지원되지 않습니다.

.NET 7
.NET 6
.NET 5
.NET Core 3.1
.NET Core 3.0
.NET Core 2.2
.NET Core 2.1
.NET Core 2.0

런타임 또는 SDK

runtime은 .NET 사용하여 만든 앱을 실행하는 데 사용됩니다. 앱 작성자는 앱을 게시할 때 앱과 함께 런타임을 포함할 수 있습니다. 앱 작성자가 런타임을 포함하지 않는 경우, 사용자가 올바른 런타임을 설치할 수 있습니다.

macOS에 설치할 수 있는 두 개의 런타임이 있으며 둘 다 SDK에 포함되어 있습니다.

ASP.NET Core 런타임
ASP.NET Core 앱을 실행합니다. .NET 런타임을 포함합니다. 설치 관리자로 사용할 수 없습니다.
.NET 런타임
이는 일반 .NET 앱을 실행하지만 ASP.NET Core 기반 앱과 같은 특수 앱은 실행하지 않습니다.

SDK는 .NET 앱 및 라이브러리를 빌드하고 게시하는 데 사용됩니다. 최신 SDK는 이전 버전의 .NET 대한 앱 빌드를 지원합니다. 일반적인 상황에서는 최신 SDK만 설치하면 됩니다.

SDK 설치에는 표준 .NET 런타임과 ASP.NET Core 런타임이 모두 포함됩니다. 예를 들어 .NET SDK 9.0이 설치되어 있는 경우 .NET 런타임 9.0 및 ASP.NET Core 9.0 런타임이 모두 설치됩니다. 그러나 다른 런타임 버전은 SDK와 함께 설치되지 않으며 별도로 설치해야 합니다.

.NET 설치하는 방법 선택

.NET 설치하는 방법에는 여러 가지가 있으며 일부 제품은 자체 버전의 .NET 관리할 수 있습니다. 자체 버전의 .NET 관리하는 소프트웨어를 통해 .NET 설치하는 경우 시스템 전체에서 사용하도록 설정되지 않을 수 있습니다. 다른 소프트웨어를 통해 .NET 설치하는 것이 미치는 영향을 이해해야 합니다.

다음 섹션의 목록을 검토한 후 어떤 방법을 선택해야 할지 잘 모르는 경우 .NET Installer 패키지 사용하려고 할 것입니다.

개발자

Visual Studio Code - C# 개발 키트

Visual Studio Code C# Dev Kit 확장을 설치하여 .NET 앱을 개발합니다. 확장은 이미 설치된 SDK를 사용하거나 새 SDK를 설치할 수 있습니다.

사용자 및 개발자

.NET Installer

독립 실행형 설치 관리자를 사용하여 .NET 설치합니다. 이 방법은 개발자 또는 사용자 컴퓨터에 .NET 설치하는 일반적인 방법입니다.
스크립트를 사용하여 .NET 설치

SDK 또는 런타임의 설치를 자동화할 수 있는 bash 스크립트입니다. 설치할 .NET 버전을 선택할 수 있습니다.
수동으로 .NET 설치

특정 폴더에 .NET 설치하고 다른 .NET 복사본과 별도로 실행해야 하는 경우 이 설치 방법을 사용합니다.

설치 .NET

설치 관리자 패키지는 .NET 설치하는 쉬운 방법인 macOS에서 사용할 수 있습니다.

브라우저를 열고 https://dotnet.microsoft.com/download/dotnet로 이동합니다.
설치하려는 .NET 버전(예: .NET 10.0 링크를 선택합니다.

이 링크를 사용하면 해당 버전의 .NET 다운로드할 수 있는 링크가 있는 페이지로 이동됩니다.

SDK를 설치하려는 경우 최신 .NET 버전을 선택합니다. SDK는 이전 버전의 .NET 대한 앱 빌드를 지원합니다.

팁

다운로드할 버전을 잘 모르는 경우 최신 버전으로 표시된 버전을 선택합니다.
이 페이지에서는 SDK 및 런타임에 대한 다운로드 링크를 제공합니다. 여기서는 .NET SDK 또는 .NET 런타임을 다운로드합니다.

이전 이미지에는 두 개의 섹션이 강조 표시되어 있습니다. SDK를 다운로드하는 경우 섹션 1을 참조하세요. .NET 런타임의 경우 섹션 2를 참조하세요.
- 섹션 1(SDK)
  
  이 섹션은 SDK 다운로드 영역입니다. macOS 행의 설치 관리자 열 아래에는 Arm64 및 x64 두 아키텍처가 나열됩니다.
  - M1 또는 M3 Pro와 같은 Apple 프로세서를 실행하는 경우 Arm64를 선택합니다.
  - Intel 프로세서를 실행하는 경우 x64를 선택합니다.
- 섹션 2 - 실행 시간
  
  이 섹션에는 런타임 다운로드가 포함되어 있습니다. macOS 행의 설치 관리자 열에 대한 링크가 비어 있습니다! 이 섹션은 ASP.NET Core 런타임 SDK 또는 binary 설치 통해서만 제공되므로 비어 있습니다.
  
  표준 .NET 런타임을 다운로드하려면 더 아래로 스크롤하십시오.
  - M1 또는 M3 Pro와 같은 Apple 프로세서를 실행하는 경우 Arm64를 선택합니다.
  - Intel 프로세서를 실행하는 경우 x64를 선택합니다.
다운로드가 완료되면 엽니다.
설치 관리자의 단계를 따릅니다.

수동으로 .NET 설치

macOS 설치 관리자 대신 SDK와 런타임을 다운로드하여 수동으로 설치할 수 있습니다. 수동 설치는 일반적으로 연속 통합 시나리오에서 일부 자동화로 수행됩니다. 일반적으로 개발자와 사용자는 설치 관리자를 사용해야 합니다.

팁

install-dotnet.sh 스크립트를 사용하여 이러한 단계를 자동으로 수행합니다.

브라우저를 열고 https://dotnet.microsoft.com/download/dotnet로 이동합니다.
설치하려는 .NET 버전(예: .NET 8.0 링크를 선택합니다.

이 링크를 사용하면 해당 버전의 .NET 다운로드할 수 있는 링크가 있는 페이지로 이동됩니다.

SDK를 설치하려는 경우 최신 .NET 버전을 선택합니다. SDK는 이전 버전의 .NET 대한 앱 빌드를 지원합니다.

팁

다운로드할 버전을 잘 모르는 경우 최신 버전으로 표시된 버전을 선택합니다.

.NET 다운로드 웹 사이트입니다. 버전 6.0부터 9.0까지 나열됩니다. 빨간색 상자는 해당 다운로드 링크를 강조 표시합니다.
설치하려는 SDK 또는 런타임에 대한 링크를 선택합니다. Binaries 열을 macOS 행에서 찾습니다.
- M1 또는 M3 Pro와 같은 Apple 프로세서를 실행하는 경우 Arm64를 선택합니다.
- Intel 프로세서를 실행하는 경우 x64를 선택합니다.
터미널을 열고 .NET 이진 파일이 다운로드된 위치로 이동합니다.
시스템에서 원하는 위치에 tarball을 추출하여 .NET을 설치합니다. 다음 예제에서는 HOME 디렉터리 ~/Applications/.dotnet을 사용합니다.
```
mkdir -p ~/Applications/.dotnet
tar -xf "dotnet-sdk-9.0.100-rc.2.24474.11-osx-arm64.tar" -C ~/Applications/.dotnet/
```

디렉터리를 .NET 설치된 위치로 변경하여 .NET 작동하는지 테스트하고 dotnet --info 명령을 실행합니다.

chdir ~/Applications/.dotnet/
./dotnet --info

스크립트를 사용하여 .NET 설치

dotnet-install 스크립트는 자동화 및 런타임의 관리자 권한이 없는 설치를 수행하는 데 사용됩니다. https://dot.net/v1/dotnet-install.sh에서 스크립트를 다운로드할 수 있습니다.

스크립트는 기본적으로 .NET 8인 최신 long term support(LTS) 버전을 설치합니다. channel 스위치를 지정하여 특정 릴리스를 선택할 수 있습니다. 런타임을 설치하려면 runtime 스위치를 포함합니다. 그렇지 않으면 스크립트가 SDK를 설치합니다.

팁

이러한 명령은 이 절차의 마지막에 스크립트 코드 조각으로 제공됩니다.

터미널을 엽니다.
~/Downloads와 같이 스크립트를 다운로드하려는 폴더로 이동합니다.
wget 명령이 없는 경우 Brew를 사용하여 설치합니다.
```
brew install wget
```
스크립트를 다운로드하려면 다음 명령을 실행합니다.
```
wget https://dot.net/v1/dotnet-install.sh
```
스크립트에 실행 권한 부여
```
chmod +x dotnet-install.sh
```
스크립트를 실행하여 .NET 설치합니다.

스크립트는 기본적으로 ~/.dotnet 디렉터리에 최신 SDK를 설치합니다.
```
./dotnet-install.sh
```

다음의 모든 명령은 단일 bash 스크립트입니다.

chdir ~/Downloads
brew install wget
wget https://dot.net/v1/dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh

~/.dotnet 폴더로 이동하고 dotnet --info 명령을 실행하여 .NET 테스트합니다.

chdir ~/.dotnet
./dotnet --info

중요합니다

일부 프로그램은 환경 변수를 사용하여 시스템에서 .NET 찾을 수 있으며 dotnet 명령을 사용하면 새 터미널을 열 때 작동하지 않을 수 있습니다. 이 문제를 해결하기 위해 시스템 전역에서 .NET을 사용 가능하게 설정 섹션을 참조하세요.

Visual Studio Code용 .NET 설치

Visual Studio Code 데스크톱에서 실행되는 강력하고 간단한 소스 코드 편집기입니다. Visual Studio Code 시스템에 이미 설치된 SDK를 사용할 수 있습니다. 또한 C# Dev Kit 확장은 아직 설치되지 않은 경우 .NET 설치합니다.

Visual Studio Code 통해 .NET 설치하는 방법에 대한 지침은 Getting Started with C# in VS Code 참조하세요.

공증

개발자 ID로 배포되는 macOS용으로 만든 소프트웨어는 .NET 사용하여 만든 앱을 포함하여 공증되어야 합니다.

공증되지 않은 앱을 실행하면 다음 이미지와 비슷한 오류 창이 표시됩니다.

macOS Catalina 공증 경고

강제 표시가 .NET(및 .NET 앱)에 미치는 영향에 대한 자세한 내용은 macOS Catalina Notarization 작업 참조하세요.

유효성 검사

설치 프로그램 또는 이진 릴리스를 다운로드한 후 파일이 변경되거나 손상되지 않았는지 확인합니다. 컴퓨터에서 체크섬을 확인한 다음 다운로드 웹 사이트에 보고된 내용과 비교할 수 있습니다.

공식 다운로드 페이지에서 파일을 다운로드하면 해당 파일의 체크섬이 텍스트 상자에 표시됩니다. 체크섬 값을 클립보드에 복사하려면 복사 단추를 선택합니다.

.NET 다운로드 페이지 및 체크섬

shasum -a 512 명령을 사용하여 다운로드한 파일의 체크섬을 인쇄합니다. 예를 들어 다음 명령은 dotnet-sdk-9.0.306-osx-x64.tar.gz 파일의 체크섬을 보고합니다.

$ shasum -a 512 dotnet-sdk-9.0.306-osx-x64.tar.gz
a9700f98e5aa4f70b2a08ddba2b1c6085106b0d17828bd719fdcef460b06c890b32d752fbff8e4659cd1ca4174b4b211b301fe682439ea9a24b6521ca5a64c69  dotnet-sdk-9.0.306-osx-x64.tar.gz

체크섬을 다운로드 사이트에서 제공한 값과 비교합니다.

체크섬 파일을 사용하여 유효성 검사

.NET 릴리스 정보에는 다운로드한 파일의 유효성을 검사하는 데 사용할 수 있는 체크섬 파일에 대한 링크가 포함되어 있습니다. 다음 단계에서는 체크섬 파일을 다운로드하고 .NET 설치 이진 파일의 유효성을 검사하는 방법을 설명합니다.

https://github.com/dotnet/core/tree/main/release-notes/9.0#releases GitHub .NET 9의 릴리스 정보 페이지에는 Releases 섹션이 포함되어 있습니다. 해당 섹션의 표는 각 .NET 9 릴리스의 다운로드 및 체크섬 파일에 연결됩니다. 다음 이미지는 .NET 8 릴리스 테이블을 참조로 보여줍니다.
다운로드한 .NET 버전의 링크를 선택합니다.

이전 섹션에서는 .NET 9.0.10 릴리스의 .NET SDK 9.0.306을 사용했습니다.
릴리스 페이지에서 .NET 런타임 및 .NET SDK 버전과 체크섬 파일에 대한 링크를 볼 수 있습니다. 다음 이미지는 .NET 8 릴리스 테이블을 참조로 보여줍니다.
체크섬 링크를 마우스 오른쪽 단추로 클릭하고 클립보드에 복사합니다.
터미널을 엽니다.
curl -O {link}를 사용하여 체크섬 파일을 다운로드합니다.

다음 명령의 링크를 복사한 링크로 바꿉니다.
```
curl -O https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt
```
체크섬 파일과 .NET 릴리스 파일이 모두 동일한 디렉터리에 다운로드되면 shasum -a 512 -c {file} 명령을 사용하여 다운로드한 파일의 유효성을 검사합니다.

유효성 검사를 통과하면 확인 상태로 인쇄된 파일이 표시됩니다.
```
$ shasum -a 512 -c 9.0.10-sha.txt
dotnet-sdk-9.0.306-osx-x64.tar.gz: OK
```
FAILED로 표시된 파일이 표시되면 다운로드한 파일이 유효하지 않으므로 사용하면 안 됩니다.
```
$ shasum -a 512 -c 9.0.10-sha.txt
dotnet-sdk-9.0.306-osx-x64.tar.gz: FAILED
shasum: WARNING: 1 computed checksum did NOT match
```

Arm 기반의 Mac

다음 섹션에서는 Arm 기반 Mac에 .NET 설치할 때 고려해야 할 사항에 대해 설명합니다.

경로 차이

Arm 기반 Mac에서는 모든 Arm64 버전의 .NET 일반 /usr/local/share/dotnet/ 폴더에 설치됩니다. 그러나 .NET SDK의 x64 버전을 설치하면 /usr/local/share/dotnet/x64/dotnet/ 폴더에 설치됩니다.

경로 변수

PATH 변수와 같이 시스템 경로에 .NET 추가하는 환경 변수는 x64 및 Arm64 버전의 .NET SDK가 모두 설치된 경우 변경해야 할 수 있습니다. 또한 일부 도구는 적절한 .NET SDK 설치 폴더를 가리키도록 업데이트해야 하는 DOTNET_ROOT 환경 변수를 사용합니다.

문제 해결

문제 해결을 위해 다음 섹션을 사용할 수 있습니다.

Arm 기반의 Mac
.NET을 시스템 전체에서 사용할 수 있게 만들기

.NET 시스템 전체에서 사용할 수 있도록 설정

경우에 따라 터미널을 포함한 시스템의 앱에서 .NET 설치되는 위치를 찾아야 합니다. .NET macOS 설치 관리자 패키지 자동으로 시스템을 구성해야 합니다. 그러나 관리 설치 방법 또는 .NET 설치 스크립트를 사용한 경우 .NET 설치된 디렉터리를 PATH 변수에 추가해야 합니다.

일부 앱은 .NET 설치된 위치를 확인하려고 할 때 DOTNET_ROOT 변수를 찾을 수 있습니다.

macOS에서는 다양한 셸을 사용할 수 있으며 각 셸에는 서로 다른 프로필이 있습니다. 예시:

Bash 셸: ~/.profile, /etc/profile
ko-KR: Korn 셸: ~/.kshrc 또는 .profile
Z 셸: ~/.zshrc 또는 .zprofile

셸 프로필에서 다음 두 환경 변수를 설정합니다.

DOTNET_ROOT

이 변수는 .NET 설치된 폴더(예: $HOME/.dotnet)로 설정됩니다.
```
export DOTNET_ROOT=$HOME/.dotnet
```
PATH

이 변수에는 DOTNET_ROOT 폴더와 DOTNET_ROOT/tools 폴더가 모두 포함되어야 합니다.
```
export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
```

피드백

이 페이지가 도움이 되었나요?

Last updated on 2026-03-06