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

• 11/30/2025
• 2 minutes to read

예제 프로젝트명: RedPlus

1. 사전 준비

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

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

  dotnet --version
  

• 터미널 환경

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

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

2. 작업 폴더 준비

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

mkdir DotNetProjects
cd DotNetProjects

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

3. Razor Pages 프로젝트 생성

dotnet new webapp 템플릿 명령으로 RedPlus라는 이름의 Razor Pages 프로젝트를 생성합니다.

dotnet new webapp -n RedPlus

생성 결과

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

RedPlus/
 ├─ Pages/
 ├─ wwwroot/
 ├─ appsettings.json
 └─ Program.cs

기본 Razor Pages 템플릿이므로 Razor Page(.cshtml), 정적 파일 폴더, 설정 파일 등이 포함되어 있습니다.

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

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

cd RedPlus

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을 브라우저에 입력하면 기본 Razor Pages 템플릿 화면을 확인할 수 있습니다.

예:

http://localhost:5233

프로젝트가 정상적으로 동작하면 기본 시작 페이지가 표시됩니다.

8. 실행 종료

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