환경 설정

필수 요구사항

1. .NET 10.0 SDK

# 버전 확인
dotnet --version
# 출력 예: 10.0.100

# 설치 (Windows)
winget install Microsoft.DotNet.SDK.10

# 설치 (macOS)
brew install --cask dotnet-sdk

# 설치 (Linux - Ubuntu)
sudo apt-get update && sudo apt-get install -y dotnet-sdk-10.0

2. IDE 설정

VS Code + C# Dev Kit

• C# Dev Kit 확장 설치

---

프로젝트 설정

새 프로젝트 생성

# 새 프로젝트 생성
dotnet new console -n MyValueObjectProject

# LanguageExt 패키지 설치
cd MyValueObjectProject
dotnet add package LanguageExt.Core

기본 using 문

프로젝트에서 사용할 기본 using 문입니다:

using LanguageExt;
using LanguageExt.Common;
using static LanguageExt.Prelude;

GlobalUsings.cs (선택사항)

프로젝트 전체에서 사용할 using 문을 한 곳에서 관리할 수 있습니다:

GlobalUsings.cs

global using LanguageExt;
global using LanguageExt.Common;
global using static LanguageExt.Prelude;

---

각 프로젝트 실행 방법

프로젝트 실행

# 특정 프로젝트로 이동
cd Docs/tutorials/Functional-ValueObject/01-Concept/01-Basic-Divide/BasicDivide

# 프로젝트 실행
dotnet run

테스트 실행

# 테스트 프로젝트로 이동
cd Docs/tutorials/Functional-ValueObject/01-Concept/01-Basic-Divide/BasicDivide.Tests.Unit

# 테스트 실행
dotnet test

전체 솔루션 빌드

# 솔루션 루트에서
dotnet build

# 전체 테스트 실행
dotnet test

---

프로젝트 구조

각 튜토리얼 프로젝트는 다음과 같은 구조를 가집니다:

01-Basic-Divide/
├── BasicDivide/                    # 메인 프로젝트
│   ├── Program.cs                  # 메인 실행 파일
│   ├── MathOperations.cs           # 핵심 로직
│   ├── BasicDivide.csproj          # 프로젝트 파일
│   └── README.md                   # 프로젝트 설명
│
└── BasicDivide.Tests.Unit/         # 테스트 프로젝트
    ├── MathOperationsTests.cs      # 테스트 파일
    ├── BasicDivide.Tests.Unit.csproj
    └── README.md

---

첫 번째 예제 실행

환경 설정이 완료되었다면, 첫 번째 예제를 실행해보세요:

cd Docs/tutorials/Functional-ValueObject/01-Concept/01-Basic-Divide/BasicDivide
dotnet run

예상 출력

=== 기본 나눗셈 함수 ===

정상 케이스:
10 / 2 = 5

예외 케이스:
10 / 0 = System.DivideByZeroException: Attempted to divide by zero.

---

문제 해결

.NET SDK가 인식되지 않는 경우

# PATH 환경 변수 확인
echo $PATH

# Windows의 경우 시스템 환경 변수에 다음 경로 추가
# C:\Program Files\dotnet

LanguageExt 패키지 설치 실패

# NuGet 소스 확인
dotnet nuget list source

# 공식 NuGet 소스 추가
dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org

IDE에서 IntelliSense가 작동하지 않는 경우

1. IDE 재시작
2. dotnet restore 실행
3. .vs 또는 .vscode 폴더 삭제 후 재시작

FAQ

Q1: .NET 10이 아닌 다른 버전에서도 실행할 수 있나요?

A: 이 튜토리얼의 프로젝트들은 .NET 10.0 SDK를 기준으로 작성되었습니다. 일부 코드는 하위 버전에서도 동작할 수 있지만, 파일 기반 프로그램 실행 등 .NET 10 전용 기능을 사용하는 부분이 있으므로 .NET 10.0 이상을 권장합니다.

Q2: GlobalUsings.cs는 반드시 만들어야 하나요?

A: 아닙니다. 선택사항입니다. 각 파일에서 using LanguageExt; 등을 직접 선언해도 동일하게 동작합니다. 프로젝트 전체에서 반복되는 using 문을 줄이고 싶을 때 사용하면 편리합니다.

Q3: LanguageExt 패키지 버전은 어떤 것을 설치해야 하나요?

A: dotnet add package LanguageExt.Core 명령을 실행하면 최신 안정 버전이 설치됩니다. 이 튜토리얼의 각 프로젝트에는 검증된 버전이 .csproj 파일에 명시되어 있으므로, 솔루션을 빌드하면 올바른 버전이 자동으로 복원됩니다.

---

다음 단계

환경 설정이 완료되었습니다. 이제 Part 1에서 기본 나눗셈 함수의 문제점을 직접 확인하고, 값 객체로 진화하는 첫 걸음을 내딛습니다.

→ 1장: 기본 나눗셈에서 시작하기