dotnet 명령으로 MVC 프로젝트 생성하기

• 11/30/2025
• 2 minutes to read

예제 프로젝트명: DotNetNote

1. 사전 준비

ASP.NET Core MVC 프로젝트 생성을 위해 다음 도구가 설치되어 있어야 합니다.

• .NET SDK (10 이상 권장) 설치 여부는 다음 명령으로 확인할 수 있습니다.

  dotnet --version
  

• 터미널 환경

  • Windows: PowerShell, Windows Terminal
  • macOS / Linux: 기본 Terminal

SDK 버전이 정상적으로 출력되면 다음 단계로 진행할 수 있습니다.

2. 작업 폴더 준비

프로젝트를 저장할 폴더를 생성한 뒤 해당 폴더로 이동합니다.

mkdir DotNetProjects
cd DotNetProjects

이미 작업용 폴더가 준비되어 있다면 이 단계는 생략할 수 있습니다.

3. MVC 프로젝트 생성

dotnet new mvc 템플릿 명령으로 DotNetNote라는 이름의 MVC 프로젝트를 생성합니다.

dotnet new mvc -n DotNetNote

생성 결과

위 명령을 실행하면 다음과 같은 폴더 구조가 자동으로 생성됩니다.

DotNetNote/
 ├─ Controllers/
 ├─ Models/
 ├─ Views/
 ├─ wwwroot/
 ├─ appsettings.json
 └─ Program.cs

기본 MVC 템플릿이므로 Controller, Razor View, 정적 파일 폴더 등이 포함되어 있습니다.

4. 프로젝트 디렉터리로 이동

생성된 프로젝트 폴더로 이동합니다.

cd DotNetNote

5. 의존성 복원

프로젝트에 필요한 NuGet 패키지를 복원합니다.

dotnet restore

일반적으로 dotnet run을 실행하면 자동으로 복원되지만, 명확한 준비 과정을 위해 별도로 수행할 수 있습니다.

6. 로컬 실행

Kestrel 웹 서버를 통해 프로젝트를 실행합니다.

dotnet run

실행 후 아래와 유사한 로그가 출력됩니다.

Building...
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5233
info: Microsoft.Hosting.Lifetime[0]
      Application started.

7. 브라우저에서 확인

표시된 URL을 브라우저에 입력하면 기본 MVC 템플릿 화면을 확인할 수 있습니다.

예:

http://localhost:5233

프로젝트가 정상적으로 동작하면 MVC 초기 화면이 표시됩니다.

8. 실행 종료

실행 중인 터미널에서 Ctrl + C 를 입력하여 서버를 종료할 수 있습니다.