게으른 자들을 위한 알짜배기 압축집.zip

오라클 클라우드 과금 방지 가이드 (무료 인스턴스 PAYG 전환 후 설정)

zippy — Tue, 30 Jun 2026 17:52:36 +0900

Oracle Cloud Infrastructure(OCI)에서 Always Free 인스턴스를 만들었지만, PAYG(Pay As You Go) 계정으로 업그레이드한 상태라면 과금이 발생할 수 있기에... 과금을 사전에 예방하기 위해 설정한 내용들을 순서대로 정리해보았습니다. (까먹을까봐)

1. 오라클 무료 계정의 과금 구조 이해

Free Tier vs PAYG

오라클 클라우드 계정은 크게 두 가지 상태가 있습니다.

구분	Free Tier (순수 무료)	PAYG (유료 전환)
유료 리소스 생성	불가능	가능
Always Free 리소스	사용 가능	사용 가능
과금 위험	없음	있음
다운그레이드	-	불가능

PAYG로 업그레이드하면 다시 무료 계정으로 되돌릴 수 없습니다. 대신 Always Free 리소스만 사용하면 비용은 발생하지 않습니다. 하지만... 프리티어 계정으로 인스턴스 만들기란 하늘의 별따기.... ⭐ 심지어 혜택 축소시킨 이후로는 무료 계정으로 VM.Standard.A1.Flex 선택지가 사라졌는데요..(저만 그런걸지도) 프리티어 계정으로 몇 달을 인스턴스 생성 시도해도 안 되길래 PAYG 전환했는데, 전환하자마자 인스턴스 생성이 되더이다... 과금의 위험이 있기에 이를 사전에 예방하고자 이것저것 설정을 해두었습니다. 하지만 오라클 너무 어렵고.. 가이드도 없다시피 하고... 정보도 얻기 어렵다......

아무튼 오라클의 예산(Budget) 기능은 설정한 임계값에 도달하면 이메일로 알림만 보내줍니다. 따라서 알림을 빠르게 받아서 직접 조치하는 것이 유일한 방법이고, 그래서 아래 설정을 꼼꼼히 해둬야 합니다.

2. 현재 리소스 점검 (과금 대상 여부 확인)

새로운 설정을 하기 전에, 지금 사용 중인 리소스가 모두 무료 범위 안에 있는지 먼저 확인합니다.

2-1. Always Free 리소스 한도

리소스	Always Free 한도
ARM(A1) VM 인스턴스	합산 2 OCPU, 12GB 메모리
AMD(E2) VM 인스턴스	2개 (각 1/8 OCPU, 1GB RAM)
부트볼륨 + 블록볼륨	합산 200GB
Object Storage	20GB
로드 밸런서	1개 (10Mbps)
아웃바운드 트래픽	월 10TB

⚠️주의: 2026년 6월 15일부로 A1(Ampere) 인스턴스의 무료 한도가 절반으로 축소되었습니다...흑흑 공식 문서를 참고하시길...

2-2. 인스턴스 Shape 확인 방법

OCI 콘솔 접속: https://cloud.oracle.com
좌측 상단 ☰ (햄버거 메뉴) 클릭
Compute > Instances 클릭
인스턴스 이름 클릭하여 상세 페이지 진입
"구성(Shape)" 항목에서 Shape 이름과 사양 확인

Always Free에 해당하는 Shape은 다음 두 가지입니다.

Shape 이름	종류	무료 한도
`VM.Standard.A1.Flex`	ARM	합산 2 OCPU, 12GB
`VM.Standard.E2.1.Micro`	AMD	각 1/8 OCPU, 1GB

예를 들어 제 경우는 다음과 같이 확인되었습니다.

Shape: VM.Standard.A1.Flex / OCPU: 1 / 메모리: 6GB

ARM 기준 한도(2 OCPU, 12GB) 내에 있으므로 안전합니다.

2-3. 부트 볼륨 확인

☰ 메뉴 > Storage > Block Storage > Boot Volumes
볼륨 크기 합산이 200GB 이하인지 확인

2-4. 기타 리소스 확인

아래 항목들도 확인하여 불필요한 유료 리소스가 없는지 점검합니다.

확인 항목	경로
블록 볼륨	☰ > Storage > Block Volumes
로드 밸런서	☰ > Networking > Load Balancers
Object Storage	☰ > Storage > Buckets

없거나 무료 한도 이내라면 안전합니다.

3. 예산(Budget) 생성 및 경보 규칙 설정

이 단계가 가장 중요합니다. 과금이 발생하면 즉시 알림을 받을 수 있도록 예산과 경보 규칙을 만듭니다.

3-1. 예산 생성 화면 진입

☰ 메뉴 > Billing & Cost Management 클릭
Cost Management > Budgets 클릭
Create Budget (예산 생성) 버튼 클릭

3-2. 예산 기본 정보 입력

항목	입력값
이름	`free-tier-guard`
설명	`과금 방지 예산 알림`
예산 범위	컴파트먼트 선택
대상 컴파트먼트	최상위(root) 컴파트먼트 선택 (본인 테넌시 이름)
일정	매월 선택
예산 금액	`1` (통화 단위는 계정에 따라 SGD, USD 등 자동 표시)
예산 처리를 시작할 월중 특정일	비워두기 (기본값 사용)

예산 금액을 1로 설정하는 이유는, 목표가 과금 0원이기 때문입니다. 1달러(또는 1 SGD)로 설정하면 단 0.01이라도 과금이 발생했을 때 빠르게 감지할 수 있습니다.

3-3. 첫 번째 경보 규칙 설정

예산 생성 화면 하단에 "예산 경보 규칙(선택사항)" 섹션이 있습니다. 여기서 첫 번째 알림을 함께 만듭니다.

항목	입력값
임계값 측정항목	실제 지출
임계값 유형	예산 백분율
임계값 %	`50`
전자메일 수신자	본인 이메일 주소
전자메일 메시지	`경고: 과금 50% 도달. 즉시 OCI 콘솔 확인 필요`

입력을 마쳤으면 하단의 "생성(Create)" 버튼을 클릭합니다.

3-4. 추가 경보 규칙 2개 더 만들기

하나의 예산에 여러 개의 경보 규칙을 추가할 수 있습니다. 방금 만든 예산에 규칙을 2개 더 추가합니다.

Budgets 목록에서 free-tier-guard 클릭
상세 페이지의 "경보 규칙" 섹션에서 "경보 규칙 생성" 클릭

경보 규칙 2: 실제 지출 100%

항목	입력값
임계값 측정항목	실제 지출
임계값 유형	예산 백분율
임계값 %	`100`
전자메일 수신자	본인 이메일 주소
전자메일 메시지	`긴급: 과금 1달러 도달! 즉시 리소스 확인 및 삭제 필요`

생성 후, 다시 "경보 규칙 생성"을 클릭하여 세 번째 규칙을 추가합니다.

경보 규칙 3: 예측 지출 80%

항목	입력값
임계값 측정항목	예측 지출
임계값 유형	예산 백분율
임계값 %	`80`
전자메일 수신자	본인 이메일 주소
전자메일 메시지	`주의: 이번 달 예상 지출이 예산 80%에 도달할 전망. 리소스 점검 필요`

4. 비용 분석(Cost Analysis)으로 현재 비용 확인

예산 설정과 별도로, 현재 비용이 실제로 0원인지 직접 눈으로 확인합니다.

☰ 메뉴 > Billing & Cost Management 클릭
Cost Management > Cost Analysis 클릭
날짜 범위를 이번 달로 설정
모든 서비스의 비용이 $0.00으로 표시되는지 확인

0이 아닌 항목이 보인다면, 해당 서비스의 리소스를 찾아 즉시 삭제해야 합니다.

5. 카드 해외결제 한도 제한 (추가 안전장치)

예산 알림은 소프트 리밋이므로, 해킹이나 실수로 유료 리소스가 대량 생성되는 최악의 상황에 대비하여 카드 자체에서 방어선을 만들어 둡니다.

설정 방법

본인 카드사 앱(토스, 카카오뱅크, 신한SOL 등) 열기
해외결제 한도 설정 메뉴 찾기
해외결제 월 한도를 최소 금액(예: 1만원 또는 5만원)으로 설정

주의: 카드 결제가 완전히 실패하면 오라클이 계정 자체를 정지시킬 수 있고, Always Free 리소스도 함께 중단될 수 있습니다. 완전 차단보다는 낮은 한도 설정이 더 안전합니다.

6. 앞으로 지켜야 할 규칙 요약

해야 할 것

규칙	이유
새 리소스 만들 때 Always Free eligible 표시 반드시 확인	유료 리소스 생성 방지
부트볼륨 + 블록볼륨 합산 200GB 초과 금지	초과분 과금
Oracle 알림 이메일 즉시 확인	예산 경보는 알림만 보내고 차단하지 않음
매월 1회 Cost Analysis에서 비용 $0 확인	습관적 점검

절대 하지 말아야 할 것

위험 행동	결과
Always Free 표시 없는 Shape 선택	유료 리소스 생성, 즉시 과금
ARM 합산 2 OCPU / 12GB 초과	초과분 과금
로드밸런서 2개 이상 생성	2번째부터 과금
Object Storage 20GB 초과	초과분 과금

정기 점검 루틴

주기	확인 항목	경로
매주	Cost Analysis 비용 $0 확인	☰ > Billing & Cost Management > Cost Analysis
매월	인보이스 확인	☰ > Billing & Cost Management > Invoices
매월	예산 상태 확인	☰ > Billing & Cost Management > Budgets
수시	알림 이메일 확인	등록한 이메일

마무리

이 글에서 설정한 것들을 정리하면 다음과 같습니다.

현재 리소스가 모두 Always Free 범위 안에 있는지 확인
예산 1달러 + 경보 규칙 3개로 과금 즉시 감지 체계 구축
카드 해외결제 한도 제한으로 최악의 상황 방어
정기 점검 루틴으로 지속적 모니터링

"AI가 기억하는 나" — 대화 기록을 기반으로 내 모습을 그리게 하는 프롬프트 공유

zippy — Mon, 18 May 2026 17:36:34 +0900

AI가 기억하는 나의 진짜 모습은 어떨까?

AI를 이용해 매일 사소한 질문을 던지고, 아이디어를 정리하다 보면 문득 이런 생각이 들 때가 있습니다. "AI는 나를 어떤 사람으로 인식하고 있을까?"

그래서 오늘은 그동안 AI와 나눈 대화의 맥락, 언어 습관, 문화적 배경을 바탕으로 AI가 추론한 '가장 현실적인 내 모습'을 스냅 사진처럼 뽑아주는 프롬프트를 공유합니다.

대화 기록으로 뽑아보는 'AI가 기억하는 나'

이 프롬프트의 핵심은 '인위적인 AI 느낌을 완전히 빼는 것'입니다. 스튜디오에서 각 잡고 찍은 사진이 아니라, 스마트폰으로 대충 찍은 듯한 현실감을 주도록 설계되었습니다. 아래 프롬프트를 복사해서 여러분이 자주 사용하는 AI의 대화창에 그대로 입력해 보세요.

바로 복붙 가능한 프롬프트

Do not ask for a photo. Do not generate a polished or AI-looking image.

Based solely on our conversation history — how I write, what I talk about,
how I think, and the language I naturally use — form an impression of who I am.

Take into account the cultural and linguistic context of our conversations
when visualizing this person. The language patterns, references, and sensibilities
I've shown should inform nationality, facial features, and overall appearance.

Render this as a candid smartphone photo of that person in a natural moment:
- Natural ambient light only (window, café, overcast outdoor)
- Loose, slightly off-center framing — not composed, just caught
- Imperfect exposure, mild grain, soft edges are welcome
- Real skin texture, real proportions — no retouching
- Muted, understated color — not vivid, not filtered
- A setting that feels consistent with where this person actually lives

The result should feel like a real photo of a real person.
Authentic over polished. Caught, not composed.

사진을 요청하지 마세요. AI가 만든 것처럼 과하게 다듬어진 이미지도 원하지 않습니다.
우리의 대화 기록만을 바탕으로 — 내가 어떻게 글을 쓰는지, 무엇에 대해 이야기하는지,
어떻게 생각하는지, 어떤 언어를 자연스럽게 사용하는지 — 내가 어떤 사람인지 인상을 형성해주세요.
내가 사용한 언어의 문화적·언어적 맥락을 시각화에 반영해주세요.
내가 보여온 언어 패턴, 표현 방식, 감수성이 국적, 외형, 전반적인 분위기에 녹아들어야 합니다.
이 사람의 자연스러운 순간을 스마트폰으로 찍은 사진처럼 표현해주세요:
- 자연광만 사용 (창가, 카페, 흐린 날 야외)
- 살짝 비대칭적인 구도, 중앙에서 약간 벗어난 프레임 — 연출이 아닌 포착
- 약간의 노출 불균형, 미세한 필름 그레인, 부드러운 아웃포커스 허용
- 보정하지 않은 자연스러운 피부, 실제 비율 유지
- 채도를 낮춘 절제된 색감 — 선명하거나 필터 낀 느낌 없이
- 이 사람이 실제로 살고 있는 곳과 어울리는 배경

완벽하게 다듬어진 이미지가 아닌, 진짜 사람의 진짜 사진처럼 느껴져야 합니다. 연출된 것이 아닌, 포착된 것처럼.

활용 팁 & 결과를 더 잘 뽑는 방법

프롬프트를 그냥 복붙만 해도 되지만, 몇 가지 조건을 알고 쓰면 훨씬 재미있는 결과가 나옵니다.

대화량이 많을수록 정확도가 올라갑니다. 짧은 세션보다는 여러 주제를 오간 긴 대화 이후에 쓰는 게 좋습니다.
이미지 생성 기능이 있는 모델에서 써야 실제로 이미지가 나옵니다. ChatGPT의 GPT-4o, Copilot 등이 해당됩니다.
결과가 너무 보정된 느낌이면 "More grain. Less polished. This looks like a stock photo." 같은 후속 프롬프트로 다듬을 수 있습니다.

나의 대화 기록으로 뽑아낸 페르소나 이미지

하다보니 재밌어서 이것저것 계속 생성해봤는데요. 현 시점에서 가장 자연스러운 이미지를 생성하는 모델은 GPT인 것 같습니다. Gemini 로 자연스러운 이미지 생성을 위해 프롬프트 변형을 시도해봤지만, 무의미한 시도인 것을 깨달았기에 금방 포기했습니다.

(1) perplexity 에서 Claude Sonnet 4.6 Thinking 모델을 이용한 결과물

(2) perplexity 에서 GPT-5.4 Thinking 모델을 이용한 결과물

(3) Claude 로 작성한 이미지 프롬프트로 chatGPT에서 이미지 생성

우리의 대화 기록을 바탕으로, 네가 생각하는 나는 어떤 사람인지 설명해줘.
그리고 그 인상을 바탕으로 ChatGPT 에서
바로 사용할 수 있는 이미지 생성 프롬프트를 영어로 작성해줘.
이미지 스타일 조건:
- 스마트폰으로 찍은 캔디드 사진 느낌
- 자연광, 비대칭 구도, 미세한 그레인
- 보정 없는 자연스러운 피부, 절제된 색감
- 내 언어 사용 패턴에서 유추한 국적과 외형 반영

(4) gemini에서 Gemini3.1 Pro 모델을 이용한 결과물

(5) gemini 로 작성한 이미지 프롬프트로 chatGPT에서 이미지 생성

perplexity 에서 GPT-5.4 Thinking 모델을 이용한 결과물

프롬프트 변형을 해봤는데 훨씬 자연스러운 결과물이 나와서 새삼 놀랐습니다.

Do not ask for a photo. Do not generate an AI-looking image.

Based solely on our conversation history — my writing style, what I talk about,
how I think, what I care about — visualize the kind of person I seem to be.

Render this as a casual smartphone photo. Think: someone pulled out their phone
and caught this person in a real moment. Not a portrait session.

Technical feel:
- Slightly underexposed or overexposed in places, like auto-exposure guessing
- Natural ambient light only — no flash, no softbox, no rim light
- Off-center, loosely framed, maybe a little tilted
- Subtle motion blur or soft focus is fine — even preferred
- No smoothed skin, no perfect features, no exaggerated bokeh
- Colors slightly cool or warm depending on the mood — never vivid or HDR

The subject should look like a real person caught in a real moment,
not someone who posed for a generated image.
Make it feel true to who you think I am.

perplexity 에서 GPT-5.4 Thinking 모델을 이용한 결과물

Analyze our entire conversation history up to this point. Based solely on my language patterns, vocabulary, cultural nuances, the specific topics I explore, and my overall thinking process, deduce my likely nationality, daily lifestyle, and persona. Do not ask me for personal details or confirm your deductions; just apply them.
Using your analysis, visualize what I most likely look like in my everyday life. Render this visualization as a candid, unretouched amateur smartphone snapshot with the following strict photographic constraints:
Subject Deduction: Authentic facial features, styling, and proportions that match the deduced demographic and cultural background. Real skin texture with natural imperfections. Absolutely no idealized, symmetrical, or "plastic" AI faces.
Contextual Setting: A mundane, everyday environment that perfectly aligns with my deduced interests, profession, or current focus.
Lighting & Quality: Flat, natural ambient light (e.g., overcast window, fluorescent room light). No studio, dramatic, or cinematic lighting. Include imperfect exposure, mild grain, and soft edges to mimic an older smartphone camera.
Framing: Loose, slightly awkward, or off-center framing. The subject should be caught in a natural moment, completely unposed and unaware of the camera.
Color & Tone: Muted, understated colors. No vivid contrast, no filters, no professional color grading.
The final image must feel like a genuine, leaked, or highly personal photo of a real person. Authentic over polished. Caught, not composed.

[유행 따라잡기] 크레파스로 낙서한 느낌의 프롬프트 공유

zippy — Mon, 18 May 2026 14:57:23 +0900

요즘 어린아이가 스케치북에 삐뚤빼뚤 그려놓은 듯한 크레파스 그림 스타일이 SNS에 많이 올라오던데, 저도 이 느낌을 구현하고 싶어서 여러 프롬프트를 시도해봤습니다. 시행착오 끝에 가장 결과가 좋았던 프롬프트를 다듬어서 공유합니다. AI가 그린 듯한 완벽한 그림이 아니라, 진짜 아이가 그린 듯한 어설프고 사랑스러운 느낌을 원하신다면 꼭 활용해 보세요. ️

️ 프롬프트

미드저니나 챗gpt 등 즐겨 쓰시는 AI 이미지 생성기에 그대로 복사해서 붙여넣으시면 됩니다. sonnet, gemini, kimi 등 다양한 모델로 다 돌려봤는데 저는 GPT 모델로 돌렸을 때 가장 귀여운 결과물이 나왔답니다 ⭐⭐

A drawing that looks like it was made by a 3-year-old toddler using crayons. 
The lines are wobbly, uneven, and clumsy. 
The composition is random and unintentional. 
Colors are scribbled outside the lines. 
No adult precision or clean strokes. 
Childlike, awkward, and charmingly messy crayon art style.

이 스타일, 이럴 때 쓰면 좋아요

이 삐뚤빼뚤한 낙서풍 스타일은 이런 상황에 활용하면 특히 매력적입니다.

반려동물 사진을 귀엽게 낙서풍으로 만들고 싶을 때: 우리 집 댕댕이나 고양이가 순식간에 3세 아이 낙서 속 주인공으로 변신합니다.
아이 선물용으로 가족사진을 독특하게 변환하고 싶을 때: 완벽한 사진보다 아이 눈높이에 맞춘 듯한 이 그림체가 아이에게 더 특별한 선물이 될 수 있습니다.
SNS 프로필이나 굿즈 제작에 어린이 드로잉 느낌을 입히고 싶을 때: 세상에 하나뿐인 엉뚱하고 귀여운 나만의 굿즈(그립톡, 스티커 등)를 만들 때 완벽한 소스가 됩니다.
일상 사진을 감성적인 이미지로 바꾸고 싶을 때: 평범한 카페 사진이나 풍경 사진도 이 스타일을 입히면 동화 속 한 장면처럼 포근하고 감성적으로 바뀝니다.

혹시 결과가 너무 깔끔하게 나오나요?

사용하시는 AI 모델에 따라 이 프롬프트를 써도 여전히 '어설픈 척하는 예쁜 일러스트'처럼 나오는 경우가 있습니다. 그럴 때는 기존 프롬프트 맨 끝에 아래 한 줄을 추가해 보세요.

Make it look less like "art inspired by a child" and more like an actual drawing made by a real 3-year-old.

이 한 줄을 추가하면 "귀여운 그림체"와 "진짜 아이 낙서"의 차이를 모델이 훨씬 더 명확하게 잡아냅니다. 어설픔의 강도를 확 높여주는 치트키 같은 문장입니다.

완벽하지 않아서 더 사랑스러운 이 크레파스 낙서 스타일로 여러분만의 특별한 이미지를 만들어보시길 바랍니다.

비하인드: 사실 '무서운(?)' 실패작도 있었습니다...

위에 공개한 프롬프트를 얻기 전에, 시행착오가 많았습니다. 처음에는 무조건 구체적으로 설명하면 AI가 더 잘 알아들을 줄 알고 아래와 같은 프롬프트를 써봤어요. (막 3살 된 아이, 해부학적 불일치, 아주 거친 질감 등)

결과가 섬뜩하게 나왔습니다. 눈코입이 기괴하게 일그러지고 크레파스 뭉친 자국이 너무 짙어서 마치 공포 영화에 나오는 저주받은 그림처럼 나왔거든요. 아기의 '순수한 낙서'를 표현하고 싶었는데, 너무 '리얼리티'만 강조하다 보니 모델이 방향성을 잘못 잡았던 것 같습니다.

그래서 제가 최종적으로 다듬은 게 본문의 프롬프트입니다. 실패작 프롬프트(아래)가 궁금하시다면 재미 삼아 복사해서 돌려보세요~~ 저는 gemini 모델로 돌려봤답니다^-^

Transform the attached image into a drawing that looks like it was made by a newly turned 3-year-old child using crayons.

Keep the main subject and overall composition loosely recognizable, but redraw everything from the perspective of a toddler.
The lines should be shaky, uneven, awkward, and clumsy.
Shapes can be slightly distorted, off-balance, and anatomically inaccurate.
Colors should look roughly scribbled, often going outside the lines.
Details should be heavily simplified.
Perspective, symmetry, proportions, and shading should feel immature and inconsistent.
The composition can feel random, naive, and unintentionally awkward.
Make the crayon texture obvious, waxy, rough, and messy, like a child pressing hard on paper.

Important:
Do not make it clean, polished, aesthetically balanced, or professionally illustrated.
Do not make it look like cute storybook art or refined digital painting.
Avoid adult precision, smooth outlines, or well-designed stylization.
It should feel genuinely childlike, messy, accidental, and charmingly awkward.

CCleaner 구독 취소 방법, Cleverbridge 참조번호 찾는 법까지 총정리

zippy — Wed, 22 Apr 2026 21:19:41 +0900

CCleaner 구독을 취소하려고 했는데, 해지 버튼 하나 찾기가 이렇게 어려울 줄 몰랐습니다.
저처럼 헤매는 분들이 없도록 단계별로 정리해 보았습니다.

왜 이렇게 복잡한가?

CCleaner는 자체 결제 시스템이 아닌 Cleverbridge라는 외부 글로벌 결제 대행 플랫폼을 통해 구독을 관리합니다. 그래서 CCleaner 공식 사이트 어디를 뒤져도 "구독 취소" 버튼을 바로 찾을 수 없습니다. CCleaner 사이트와 Cleverbridge 사이트를 오가며 정보를 확인해야 하기 때문에, 이 과정을 모르면 한참을 헤매게 됩니다.

사전 준비물

구독 취소를 위해 아래 두 가지 정보가 필요합니다.

필요 정보	설명
구매 시 사용한 이메일 주소	CCleaner를 결제할 때 입력한 이메일
Cleverbridge 참조번호	결제 대행사에서 부여한 주문 번호 (구매 확인 메일에 기재)

구매 확인 메일을 이미 삭제했거나 참조번호를 모르는 경우가 대부분일 텐데, 걱정하지 마세요. 아래 1단계에서 참조번호를 다시 확인하는 방법부터 안내합니다.

1단계: Cleverbridge에서 구매 내역 조회하기

먼저 Cleverbridge 고객 지원 페이지에 접속하여 참조번호를 확인합니다.

접속 주소: https://www.cleverbridge.com/?scope=cusecolp

위 링크로 접속합니다.
"Email" 입력란에 CCleaner 구매 시 사용한 이메일 주소를 입력합니다.
보안 문자(CAPTCHA)를 입력합니다.
제출 버튼을 클릭합니다.

참고: 이 페이지는 Cleverbridge의 Purchase Lookup(구매 조회) 페이지입니다.
해당 이메일로 처리된 모든 주문 내역을 조회할 수 있습니다.

2단계: 이메일에서 참조번호 확인하기

1단계를 완료하면, 입력한 이메일 주소로 주문 개요(Order Overview) 메일이 발송됩니다.

이메일 수신함을 확인합니다. (스팸함도 확인해 주세요)
Cleverbridge에서 보낸 메일을 열어봅니다.
메일 본문에 Cleverbridge 참조번호(Reference Number)가 기재되어 있습니다.
이 참조번호를 복사해 둡니다.

3단계: CCleaner 구독 관리 페이지에서 정보 입력하기

이제 CCleaner 공식 구독 관리 페이지로 이동합니다.

접속 주소: https://www.ccleaner.com/ko-kr/subscription-management

위 링크로 접속합니다.
"Email address" 란에 구매 시 사용한 이메일 주소를 입력합니다.
"Cleverbridge reference number" 란에 2단계에서 확인한 참조번호를 입력합니다.
"Submit" 버튼을 클릭합니다.

참고: 정보가 정상적으로 확인되면 Cleverbridge 구독 관리 화면으로 자동 리다이렉트됩니다.
CCleaner 구독 관리 페이지에도 "we will redirect you to Cleverbridge if we verify your information successfully"라고 안내되어 있습니다.

4단계: 자동 갱신 비활성화(구독 취소) 완료하기

Cleverbridge 구독 관리 화면에 진입했다면, 이제 거의 다 왔습니다.

리다이렉트된 페이지에서 현재 활성화된 구독 정보를 확인합니다.
"자동 갱신 비활성화" (또는 "Cancel auto-renewal" / "Disable auto-renewal") 옵션을 찾아 클릭합니다.
취소 확인 절차를 완료합니다.
자동 갱신이 비활성화되었다는 확인 메시지가 표시되면 완료입니다.

✅ 자동 갱신을 비활성화하면, 현재 구독 기간이 끝나는 날까지는 정상적으로 CCleaner를 사용할 수 있습니다.
다음 결제일에 자동으로 요금이 청구되지 않습니다.

요즘 서비스는 설정 페이지에서 클릭 한두 번이면 해지할 수 있는 시대인데 구독 하나 취소하는 데 이런 과정을 거쳐야 한다는 게 놀라웠습니다. CCleaner는 외부 결제 대행사를 거치는 구조 때문에 직관적이지 않습니다.

특히 참조번호를 모르면 CCleaner 사이트만으로는 구독 취소 자체가 불가능하다는 점이 가장 큰 함정입니다. 이 글이 저처럼 헤매는 분들께 도움이 되길 바랍니다.

[Windows 11] 홈(Home) 버전 그룹 정책 편집기(gpedit.msc) 1분 만에 활성화하는 방법

zippy — Wed, 22 Apr 2026 12:37:28 +0900

안녕하세요! 윈도우 11 Home 버전을 사용하시다 보면 시스템 설정을 내 입맛대로 세밀하게 바꾸고 싶을 때가 있죠
하지만 실행 창에 gpedit.msc를 입력해도 '찾을 수 없습니다'라는 오류창만 떠서 당황하신 적 있으실 겁니다

로컬 그룹 정책 편집기는 원래 Pro 버전 이상에서만 기본으로 제공되는 기능입니다
하지만 Home 버전에도 관련 시스템 파일이 숨겨져 있기 때문에, 외부 프로그램 다운로드 없이 명령어 몇 줄만으로 아주 쉽고 안전하게 활성화할 수 있습니다

가장 깔끔하고 확실한 두 가지 방법을 차근차근 안내해 드릴 테니 편한 방법을 선택해 보세요

1. 명령 프롬프트(CMD)로 한 번에 활성화하기 (추천)

메모장 파일을 따로 만들 필요 없이 터미널 창에서 바로 활성화하는 가장 깔끔한 방법입니다
불필요한 파일이 남지 않아 시스템을 미니멀하게 관리하고 싶은 분들께 추천해 드립니다

진행 순서

작업 표시줄의 시작 메뉴(윈도우 로고)를 누르고 검색창에 cmd를 입력합니다
검색 결과에 나온 명령 프롬프트를 마우스 우클릭한 뒤 [관리자 권한으로 실행]을 클릭합니다
까만 터미널 창이 열리면, 아래 첫 번째 명령어를 그대로 복사해서 붙여넣고 Enter를 누릅니다

FOR %F IN ("%SystemRoot%\servicing\Packages\Microsoft-Windows-GroupPolicy-ClientTools-Package~*.mum") DO (DISM /Online /NoRestart /Add-Package:"%F")

설치가 주르륵 진행된 후 완료되면, 이어서 아래 두 번째 명령어를 복사해 붙여넣고 Enter를 누릅니다

FOR %F IN ("%SystemRoot%\servicing\Packages\Microsoft-Windows-GroupPolicy-ClientExtensions-Package~*.mum") DO (DISM /Online /NoRestart /Add-Package:"%F")

작업이 100% 완료되었다면 창을 닫아주시면 됩니다

2. 배치 파일(.bat)을 만들어서 실행하기

위의 명령어 복사 과정이 번거롭거나, 나중에 포맷 후 다시 사용하기 위해 파일로 보관해두고 싶으신 분들을 위한 방법입니다

진행 순서

윈도우 검색창에 메모장을 검색하여 실행합니다
아래의 코드를 전부 복사하여 메모장에 붙여넣습니다

@echo off 
pushd "%~dp0"
dir /b %SystemRoot%\servicing\Packages\Microsoft-Windows-GroupPolicy-ClientExtensions-Package~3*.mum >List.txt 
dir /b %SystemRoot%\servicing\Packages\Microsoft-Windows-GroupPolicy-ClientTools-Package~3*.mum >>List.txt 
for /f %%i in ('findstr /i . List.txt 2^>nul') do dism /online /norestart /add-package:"%SystemRoot%\servicing\Packages\%%i" 
pause

메모장 왼쪽 위 메뉴에서 [파일] - [다른 이름으로 저장]을 클릭합니다
파일 형식은 반드시 모든 파일(.)로 변경하고, 파일 이름은 gpedit_enabler.bat으로 입력한 뒤 바탕화면에 저장합니다
바탕화면에 생성된 톱니바퀴 모양의 아이콘을 마우스 우클릭하고 [관리자 권한으로 실행]을 누릅니다
파란색 창이나 검은색 창이 뜨면서 자동으로 설치가 진행되며 "계속하려면 아무 키나 누르십시오"라는 문구가 나오면 엔터를 쳐서 마무리합니다

3. 제대로 설치되었는지 확인하기

설치가 무사히 끝났다면 이제 그룹 정책 편집기를 실행해 볼 차례입니다

키보드에서 윈도우 키 + R을 동시에 눌러 실행 창을 띄웁니다
빈칸에 gpedit.msc를 입력하고 확인을 누릅니다
로컬 그룹 정책 편집기 창이 정상적으로 열렸다면 성공입니다

이제 Home 버전에서도 윈도우 자동 업데이트 강제 재부팅을 막거나, 시작 메뉴의 Bing 웹 검색을 끄는 등 나만의 쾌적한 PC 환경을 자유롭게 세팅해 보시길 바랍니다

Windows 11 전체 서비스 기능 설명 및 상태 설정 총정리

zippy — Tue, 21 Apr 2026 18:17:37 +0900

2026.04.21 - [까먹음 방지.zip] - 윈도우11 서비스 최적화 완벽 가이드: 불필요한 서비스 끄기 추천 목록

윈도우11 서비스 최적화 완벽 가이드: 불필요한 서비스 끄기 추천 목록

컴퓨터를 쓰다 보면 어느 순간부터 부팅이 느려지거나 왠지 모르게 버벅거리는 느낌, 다들 한 번쯤 겪어보셨죠? 그 이유는 바로 화면에 보이지 않는 곳에서 혼자 몰래 실행되고 있는 '백그라운

ssunhy.com

지난 1편에서 누구나 쉽게 따라 할 수 있는 '필수 비활성화 목록'을 적용해 보셨나요? 이번 2편은 거기서 한 걸음 더 나아간 '윈도우 11 전체 서비스 총정리' 심화 편입니다!

무작정 다 끄는 게 아니라 컴퓨터가 고장 나지 않게 안정성은 꽉 잡으면서, 내 피 같은 메모리와 CPU를 몰래 갉아먹는 불필요한 녀석들만 쏙쏙 골라내 잠재우는 것이 이번 글의 진짜 목표입니다.

수많은 영어 이름들 속에서 내 컴퓨터에 있는 걸 어떻게 다 찾을지 막막하시다고요? 전혀 걱정하지 마세요! 여러분이 아주 쉽게 찾으실 수 있도록 알파벳과 한글 순서대로 깔끔하게 정리해 두었답니다.

키보드에서 Ctrl + F 키를 동시에 누르고 찾고 싶은 서비스 이름을 검색하시면 눈 깜짝할 새에 찾으실 수 있을 거예요. 자, 그럼 내 PC에 딱 맞는 맞춤형 최적화를 완성하러 가볼까요?

권장 상태 범례

자동: 시스템 부팅 시 항상 실행 (윈도우 핵심 요소)
수동(트리거): 특정 조건이나 앱 실행 시에만 작동 (기본값 유지 권장)
사용 안 함: 일반적인 사용자 환경에서 불필요 (비활성화 시 시스템 자원 확보)

A ~ D 분류 서비스 목록

서비스 이름	기능 설명 및 필요 여부 (비고)	권장 상태
AarSvc	음성 대화형 에이전트 활성화 런타임	수동
ActiveX Installer (AxInstSV)	ActiveX 컨트롤 설치 관리 (최신 브라우저 환경 불필요)	사용 안 함
App Readiness	첫 로그인 및 새로운 앱 추가 시 앱 준비 처리	수동
Application Identity	응용 프로그램 ID 검증 (AppLocker 미사용 시 기본값)	수동
Application Layer Gateway Service	인터넷 연결 공유를 위한 타사 프로토콜 지원 (일반 PC 불필요)	사용 안 함
AppX Deployment Service	Microsoft Store 앱 배포 인프라 지원	자동(트리거)
AVCTP 서비스	블루투스 오디오 비디오 제어 전송	수동(트리거)
Background Intelligent Transfer	유휴 네트워크 대역폭 활용 백그라운드 파일 전송 (업데이트 필수)	수동
Background Tasks Infrastructure	시스템 백그라운드 작업 제어 인프라 (절대 유지)	자동
Base Filtering Engine	방화벽 및 IPsec 정책 관리 (보안 핵심 요소)	자동
BitLocker Drive Encryption Service	드라이브 암호화 기능 (기능 미사용 시 수동 유지)	수동(트리거)
Bluetooth 오디오 게이트웨이	블루투스 핸즈프리 프로필 오디오 게이트웨이 역할	수동(트리거)
Bluetooth 지원 서비스	원격 블루투스 디바이스 검색 및 연결 (블루투스 기기 사용 시 필수)	수동(트리거)
CaptureService	선택적 화면 캡처 기능 활성화 지원	수동
cbdhsvc	기기 간 클립보드 기록 및 동기화	자동(지연)
Certificate Propagation	스마트 카드 인증서 전파 (스마트 카드 미사용 시 불필요)	사용 안 함
Client License Service (ClipSVC)	Microsoft Store 라이선스 인프라 지원	수동(트리거)
CNG Key Isolation	암호화 키 프로세스 격리 보안 (유지 권장)	수동(트리거)
COM+ Event System	시스템 이벤트 알림 제공 핵심 기능 (절대 유지)	자동
Connected User Experiences	사용자 진단 및 사용 정보 전송 (개인정보 보호 목적 비활성화 가능)	사용 안 함
CoreMessaging	시스템 구성 요소 간 통신 관리 (핵심 서비스)	자동
Credential Manager	자격 증명 안전 저장 및 검색 지원	수동
Cryptographic Services	파일 서명 확인 및 인증서 관리 (시스템 보안 핵심)	자동(트리거)
DCOM Server Process Launcher	COM 및 DCOM 서버 실행 프로세스 (종료 시 부팅 불가 위험)	자동
DHCP Client	IP 주소 및 DNS 레코드 자동 할당 (인터넷 연결 필수)	자동
Diagnostic Policy Service	윈도우 문제 검색 및 해결 진단 정책	수동
Distributed Link Tracking Client	네트워크 간 파일 연결 유지 (단일 PC 환경 불필요)	사용 안 함
DNS Client	DNS 쿼리 전송 및 이름 해석 (인터넷 연결 필수)	자동(트리거)
Downloaded Maps Manager	오프라인 지도 앱 다운로드 관리 (지도 앱 미사용 시 불필요)	사용 안 함

E ~ N 분류 서비스 목록

서비스 이름	기능 설명 및 필요 여부 (비고)	권장 상태
Encrypting File System (EFS)	파일 암호화 기술 제공	수동(트리거)
Extensible Authentication Protocol	네트워크 인증 프로토콜 (VPN 등 미사용 시 수동)	수동
Fax	팩스 송수신 리소스 (팩스 미사용 시 불필요)	사용 안 함
Function Discovery Resource	네트워크에서 PC 리소스 게시 (공유 기능 필수)	수동(트리거)
Geolocation Service	시스템 현재 위치 모니터링 (위치 기반 서비스 필수)	수동(트리거)
Group Policy Client	관리자 구성 그룹 정책 적용 (도메인 환경 필수)	자동(트리거)
Human Interface Device Service	키보드 및 미디어 장치 특수 단추 활성화	수동(트리거)
Hyper-V 관련 서비스 모음	가상 머신 데이터 교환 및 동기화 (가상 머신 미사용 시 수동)	수동
IKE and AuthIP IPsec Keying	IPsec 키 지정 모듈 호스트 (VPN 환경에서 필요)	수동(트리거)
Internet Connection Sharing	인터넷 연결 핫스팟 공유 (미사용 시 불필요)	사용 안 함
IP Helper	IPv6 전환 기술 터널 연결 지원	수동
LG Device Managers / Time	제조사 전용 장치 및 시간 제어 관리 (미사용 시 비활성화)	사용 안 함
Link-Layer Topology Discovery	네트워크 연결 맵 생성 (일반 사용자 불필요)	사용 안 함
Local Session Manager	로컬 사용자 세션 관리 (핵심 시스템 요소)	자동
Microsoft Account Sign-in	MS 계정 로그인 지원 인프라	수동(트리거)
Microsoft Defender 바이러스 백신	악성 소프트웨어 방지 시스템 (보안 핵심 유지)	자동
Microsoft Edge Update Service	엣지 브라우저 최신 상태 유지 관리	자동(지연)
Microsoft iSCSI Initiator Service	원격 iSCSI 서버 연결 세션 관리 (일반 PC 불필요)	사용 안 함
Microsoft Passport	시스템 로그온 암호화 키 격리	수동(트리거)
Microsoft 사용량 및 품질 Insights	환경 품질 데이터 수집 텔레메트리 (사용 안 함 권장)	사용 안 함
Net.Tcp Port Sharing Service	TCP 포트 공유 기능 (개발 환경 외 불필요)	사용 안 함
Netlogon	도메인 컨트롤러 보안 채널 유지 (개인 계정 PC 불필요)	사용 안 함
Network List Service	연결 네트워크 식별 및 속성 관리	수동
Network Store Interface Service	네트워크 수정 사항 전달 (종료 시 연결 끊김)	자동

O ~ S 분류 서비스 목록

서비스 이름	기능 설명 및 필요 여부 (비고)	권장 상태
OpenSSH Authentication Agent	공용 키 인증 개인 키 보관 에이전트 (미사용 시 불필요)	사용 안 함
Optimize drives	저장소 드라이브 파일 조각 모음 최적화	수동
Performance Logs & Alerts	성능 데이터 수집 및 로그 기록	수동
Phone Service	PC 장치 전화 통신 상태 관리 (통화 기능 미사용 시 불필요)	사용 안 함
Plug and Play	하드웨어 변경 내용 자동 인식 (USB 등 인식 필수)	수동
Portable Device Enumerator	이동식 저장 장치 강제 제어 정책 (일반 환경 불필요)	사용 안 함
Power	전원 정책 및 디스플레이 절전 관리 (절대 유지)	자동
Print Spooler	프린터 인쇄 대기열 작업 스풀링 (인쇄 기능 필수)	자동
Problem Reports Control Panel	문제 보고서 제어판 지원 (불필요한 리소스 낭비 방지)	사용 안 함
Quality Windows Audio Video	네트워크 스트리밍 응용 프로그램 지원 (미사용 시 불필요)	사용 안 함
Remote Desktop Configuration	원격 데스크톱 세션 구성 (원격 미사용 시 사용 안 함)	사용 안 함
Remote Registry	원격 레지스트리 수정 허용 (보안 강화를 위해 반드시 끄기)	사용 안 함
Routing and Remote Access	광역 네트워크 라우팅 지원 (일반 PC 불필요)	사용 안 함
Secondary Logon	대체 자격 증명 프로세스 시작 지원	수동
Security Accounts Manager	로컬 보안 계정 관리자 (계정 로그온 필수 요소)	자동
Sensor Data / Monitoring Service	조도 및 방향 센서 모니터링 (자동 밝기 미사용 시 불필요)	사용 안 함
Server	파일 및 프린터 네트워크 공유 인프라	자동(트리거)
Shared PC Account Manager	공용 PC 프로필 자동 관리 (개인 PC 불필요)	사용 안 함
Smart Card (관련 서비스 포함)	스마트 카드 리더 접근 관리 (기기 미보유 시 불필요)	사용 안 함
SNMP 트랩	장비 관리 단순 네트워크 프로토콜 트랩 (일반 사용자 불필요)	사용 안 함
Software Protection	윈도우 디지털 라이선스 인증 관리	자동(지연)
SSDP Discovery	네트워크 UPnP 장치 검색 프로토콜	수동
SysMain	자주 쓰는 앱 사전 로드 (최신 SSD 탑재 PC에서는 불필요)	사용 안 함
System Event Notification Service	시스템 로그인 및 전원 이벤트 알림	자동

T ~ Z 분류 서비스 목록

서비스 이름	기능 설명 및 필요 여부 (비고)	권장 상태
Task Scheduler	자동화 작업 예약 실행 필수 인프라 (절대 유지)	자동(트리거)
Telephony	전화 통신 장치 제어 TAPI 지원 (일반 PC 불필요)	사용 안 함
Themes	사용자 바탕화면 테마 관리	자동
User Manager	다중 사용자 세션 관리 런타임	자동(트리거)
User Profile Service	사용자 프로필 데이터 로드 처리 (로그온 필수)	자동
WalletService	전자지갑 클라이언트 호스트 기능 (미사용 시 비활성화)	사용 안 함
Windows Audio	윈도우 오디오 관리 (소리 출력 필수 서비스)	자동
Windows Biometric Service	생체 인식 (Windows Hello) 데이터 처리	자동(트리거)
Windows Connection Manager	네트워크 자동 연결 및 끊기 관리	자동(트리거)
Windows Defender Firewall	인터넷을 통한 무단 액세스 방지 방화벽 (보안 핵심)	자동
Windows Encryption Provider	타사 암호화 공급자 검사 손상 방지 (미사용 시 불필요)	사용 안 함
Windows Error Reporting Service	윈도우 및 프로그램 오류 보고서 전송	사용 안 함
Windows Event Log	이벤트 쿼리 및 로그 보관 (시스템 안정성 유지 필수)	자동
Windows Font Cache Service	글꼴 데이터 캐싱으로 앱 성능 최적화	자동
Windows Management Instrumentation	시스템 관리 정보 제공 공용 인터페이스 (다수 앱 의존)	자동
Windows Media Player Network	미디어 라이브러리 DLNA 공유 (미사용 시 불필요)	사용 안 함
Windows Search	파일 및 콘텐츠 인덱싱 검색 엔진	수동
Windows Time	네트워크 시간 자동 동기화	수동(트리거)
Windows 업데이트	윈도우 시스템 보안 업데이트 다운로드	수동(트리거)
Windows 참가자 서비스	참가자 프로그램 인프라 지원 (인사이더 미가입 시 불필요)	사용 안 함
Wired AutoConfig	유선 이더넷 보안 인증	사용 안 함
WLAN AutoConfig	무선 인터넷(Wi-Fi) 연결 구성 및 검색 (필수 유지)	자동
Work Folders	기업 클라우드 폴더 서버 동기화 (개인 불필요)	사용 안 함
WWAN AutoConfig	모바일 광대역(LTE 등) 연결 데이터 관리	사용 안 함
Xbox 관련 서비스 모음	Xbox 게임 저장 및 액세서리 관리 (미사용 시 비활성화)	사용 안 함

기타 한글 명칭 서비스 목록

서비스 이름	기능 설명 및 필요 여부 (비고)	권장 상태
결제 및 NFC/SE 관리자	근거리 통신 보안 요소 관리 (PC 미사용 시 불필요)	사용 안 함
데이터 사용량	네트워크 배경 데이터 제한 측정	수동
로컬 프로필 관리자 서비스	모바일 가입자 식별 모듈 프로필 관리	사용 안 함
모바일 연결 관리 서비스	셀룰러 모바일 연결 제어 지원	사용 안 함
보안 센터	바이러스 백신 및 방화벽 상태 알림 기능	자동(지연)
셀룰러 시간	모바일 네트워크 시간 설정 지원	사용 안 함
소매 데모 서비스	매장 전시용 디스플레이 데모 활동	사용 안 함
언어 환경 서비스	시스템 추가 언어 리소스 배포 지원	수동
인벤토리 및 호환성 평가 서비스	백그라운드 텔레메트리 데이터 유지 관리 (최적화 비활성화)	사용 안 함
자녀 보호	자녀 계정 제한 기능 (사용자 환경에 맞게 설정)	사용 안 함
자동 표준 시간대 업데이트	위치 기반 시스템 표준 시간대 변경	사용 안 함

마무리 요약

본인의 PC 하드웨어 환경과 목적에 맞춘 세밀한 최적화 세팅을 완료하시기 바랍니다.
잘못된 시스템 서비스 중지 시 예기치 않은 오류가 발생할 가능성이 존재합니다.
설정 값 변경 전 반드시 윈도우 시스템 복원 지점 생성을 권장합니다.

윈도우11 서비스 최적화 완벽 가이드: 불필요한 서비스 끄기 추천 목록

zippy — Tue, 21 Apr 2026 17:58:05 +0900

컴퓨터를 쓰다 보면 어느 순간부터 부팅이 느려지거나 왠지 모르게 버벅거리는 느낌, 다들 한 번쯤 겪어보셨죠? 그 이유는 바로 화면에 보이지 않는 곳에서 혼자 몰래 실행되고 있는 '백그라운드 서비스'들 때문일 가능성이 큽니다.

비유하자면, 윈도우라는 거대한 회사 안에 굳이 필요 없는 직원들이 사무실 자리를 차지하고 컴퓨터의 체력(메모리와 CPU)을 낭비하고 있는 것과 같습니다. 이 글에서는 '내 컴퓨터에서는 전혀 쓸데없는' 윈도우 기본 서비스들을 안전하게 잠재워서 컴퓨터 속도를 쾌적하게 만드는 방법을 아주 쉽게 알려드리겠습니다. 컴퓨터를 잘 모르시는 분들도 천천히 따라오시면 전혀 문제없습니다!

잠깐! 시작하기 전에 '안전벨트' 먼저 매고 갈까요?

컴퓨터의 내부 설정을 건드릴 때는, 혹시 모를 상황에 대비해 언제든 과거로 돌아갈 수 있는 '되돌리기 버튼(시스템 복원 지점)'을 만들어 두는 것이 아주 중요합니다. 게임에서 중요한 보스전에 들어가기 전에 세이브를 해두는 것과 완벽하게 똑같습니다. 딱 1분만 투자해서 아래 순서대로 먼저 진행해 주세요.

[초간단 세이브 파일(복원 지점) 만드는 법]

키보드에서 윈도우 키를 누르거나 화면 아래 돋보기(검색) 아이콘을 클릭합니다.
검색창에 "복원 지점 만들기"라고 입력한 후, 맨 위에 나오는 제어판 결과를 클릭해서 실행합니다.
작은 창이 뜨면, 화면 아래쪽에 있는 [만들기] 버튼을 클릭합니다.
빈칸에 오늘 날짜나 기억하기 쉬운 이름(예: "최적화 하기 전")을 적어 넣고 다시 [만들기]를 누르면 끝입니다!

자, 이제 안전한 세이브 파일도 만들었으니 마음 편하게 불필요한 윈도우 서비스들을 대청소하러 가볼까요?

1. 윈도우 서비스 설정 방법

실행 창 오픈: 키보드의 Win + R 키를 동시에 누릅니다.
서비스 관리자 실행: 창이 뜨면 services.msc 라고 입력하고 확인을 누릅니다.
속성 변경: 설정하려는 서비스 이름을 찾아 마우스 오른쪽 버튼을 클릭하고 [속성]을 선택합니다.
시작 유형 수정: '시작 유형'을 아래 표에 나와 있는 권장 상태인 [사용 안 함] 또는 [수동]으로 변경하고 적용을 누릅니다.

2. 필수 비활성화(사용 안 함) 추천 목록

아래 목록은 일반적인 가정용/사무용 PC 환경에서 비활성화해도 무방하며, 불필요한 리소스 낭비를 막아주는 서비스들입니다. 정확한 서비스 이름을 확인하고 변경해 주세요.

서비스 이름 (Service Name)	기능 설명 및 비고	권장 상태
ActiveX Installer (AxInstSV)	현대 브라우저(크롬, 엣지 등)에서는 사용하지 않는 ActiveX 설치 관리	사용 안 함
Application Layer Gateway Service	인터넷 연결 공유를 위한 타사 프로토콜 지원 (일반 환경 불필요)	사용 안 함
Certificate Propagation	스마트 카드 인증서 전파 (스마트 카드 미사용 시 불필요)	사용 안 함
Connected User Experiences and Telemetry	MS에 진단 데이터 전송 (개인정보 보호 및 리소스 절약 목적)	사용 안 함
Distributed Link Tracking Client	네트워크 간 연결 유지 (단일 PC 사용 환경에서는 불필요)	사용 안 함
Downloaded Maps Manager	윈도우 오프라인 지도 앱 전용 서비스	사용 안 함
Fax	팩스 송수신 관련 서비스	사용 안 함
Internet Connection Sharing (ICS)	PC를 핫스팟으로 쓰지 않는다면 불필요	사용 안 함
LG Device Managers / LG Time Manager	제조사(LG) 전용 관리 기능 (관련 소프트웨어 미사용 시)	사용 안 함
Link-Layer Topology Discovery Mapper	네트워크 맵 생성 기능 (일반 사용자 불필요)	사용 안 함
Microsoft iSCSI Initiator Service	서버/NAS 직접 연결을 하지 않는다면 불필요	사용 안 함
Microsoft Windows SMS 라우터 서비스	PC에서 SMS 송수신 기능을 사용하지 않는다면 불필요	사용 안 함
Microsoft 사용량 및 품질 Insights	진단 및 인사이트 데이터 수집 (텔레메트리 관련)	사용 안 함
Net.Tcp Port Sharing Service	개발 환경이 아니라면 일반 PC에서는 불필요	사용 안 함
Netlogon	회사 도메인 컨트롤러 인증 (개인 PC 불필요)	사용 안 함
Network Connectivity Assistant	기업용 DirectAccess 기능 (일반 PC 불필요)	사용 안 함
OpenSSH Authentication Agent	SSH 키 관리 (서버 관리/개발 용도가 아니면 불필요)	사용 안 함
Phone Service	PC의 전화 통신 기능	사용 안 함
Portable Device Enumerator Service	이동식 장치 그룹 정책 관련	사용 안 함
Problem Reports Control Panel Support	문제 보고서 제어판 지원 기능	사용 안 함
Quality Windows Audio Video Experience	홈 네트워크 미디어 스트리밍 미사용 시 불필요	사용 안 함
Remote Desktop Configuration / Services	다른 PC에서 원격 데스크톱으로 접속하지 않는다면 끄기	사용 안 함
Remote Registry	원격으로 레지스트리 수정 허용 (보안 강화를 위해 반드시 끄기)	사용 안 함
Routing and Remote Access	라우팅 서비스 (일반 PC에서는 불필요)	사용 안 함
Sensor Data Service / Sensor Service	디스플레이 자동 밝기나 태블릿 모드 센서를 안 쓴다면 불필요	사용 안 함
Shared PC Account Manager	공용 PC 프로필 관리 기능 (개인 PC 불필요)	사용 안 함
Smart Card / Device Enumeration	스마트 카드(IC 카드 리더기 등) 미사용 시 불필요	사용 안 함
SNMP 트랩	네트워크 장비 트랩 메시지 수신 (일반 사용자 불필요)	사용 안 함
SysMain	자주 쓰는 앱을 메모리에 미리 로드 (SSD 환경에서는 체감 적음)	사용 안 함
Telephony	전화 통신 장치 제어 기능	사용 안 함
WalletService	전자지갑 클라이언트 기능	사용 안 함
Windows Error Reporting Service	시스템 오류 시 MS로 보고서 전송 기능	사용 안 함
Windows Media Player Network Sharing Service	DLNA 미디어 라이브러리 네트워크 공유	사용 안 함
Windows 상태 및 최적화된 환경	디바이스 모니터링 관련 텔레메트리 서비스	사용 안 함
Wired AutoConfig / WWAN AutoConfig	기업용 802.1X 유선 인증 및 셀룰러 모뎀(LTE) 미사용 시	사용 안 함
Work Folders	클라우드 폴더 서버 동기화 기능	사용 안 함
Xbox Accessory / Live 게임 저장 / 네트워킹	Xbox 컨트롤러나 게임 패스 기능을 안 쓴다면 모두 비활성화	사용 안 함
자녀 보호	자녀 계정 제한 기능을 쓰지 않는다면 불필요	사용 안 함

3. ⚙️ 시스템 핵심 유지 권장 목록 (수동/자동)

이 목록은 윈도우가 정상적으로 작동하거나 특정 기능을 실행할 때 반드시 필요한 핵심 서비스들입니다. 임의로 변경하지 않고 기본값인 '수동' 또는 '자동' 상태를 그대로 유지하는 것을 권장합니다.

서비스 이름 (Service Name)	상태 유지 권장 사유	권장 시작 유형
App Readiness	새로운 앱 추가 및 로그인 시 앱 준비에 필수	수동
Background Intelligent Transfer Service	윈도우 업데이트 및 스토어 다운로드에 필수적임	수동
Base Filtering Engine	방화벽 및 보안 정책을 관리하는 핵심 요소	자동
Bluetooth 지원 서비스 / 오디오 게이트웨이	무선 이어폰, 마우스 등 블루투스 기기 연결에 필수	수동(트리거)
CoreMessaging	시스템 구성 요소 간의 핵심 통신 관리	자동
Cryptographic Services	윈도우 업데이트 서명 및 인증서 검증을 위한 핵심 보안	자동(트리거)
DCOM Server Process Launcher	시스템 핵심 프로세스 실행기 (끄면 부팅이 안 될 수 있음)	자동
DHCP Client	인터넷 주소(IP)를 자동으로 받아오기 위해 절대 끄지 말 것	자동
DNS Client	도메인 이름을 해석하는 인터넷 접속 필수 서비스	자동(트리거)
Group Policy Client	그룹 정책 적용을 위해 필요	자동(트리거)
Microsoft Defender 바이러스 백신 서비스	윈도우 기본 백신 보안의 핵심	자동
Plug and Play	USB 등 하드웨어를 연결했을 때 인식하는 기능	수동
Power	PC의 전원 관리 및 절전 모드 관리에 필수	자동
Print Spooler	프린터를 사용하여 인쇄를 하려면 반드시 켜두어야 함	자동
Security Accounts Manager	로컬 계정 보안 관리에 필수	자동
Windows Audio / Endpoint Builder	소리를 출력하고 오디오 장치를 인식하는 필수 서비스	자동
Windows Defender Firewall	외부의 침입을 막는 기본 윈도우 방화벽	자동
Windows 업데이트 / Orchestrator Service	윈도우 최신 보안 패치 및 업데이트 다운로드	수동(트리거) / 자동
WLAN AutoConfig	무선 인터넷(Wi-Fi) 연결을 위해 반드시 필요	자동

마치며

컴퓨터의 성능은 불필요한 백그라운드 프로세스를 얼마나 잘 통제하느냐에 따라 크게 달라집니다. 위 표를 참고하여 내 PC 환경에 맞지 않는 서비스들을 꼼꼼하게 정리해 보세요. 훨씬 빠릿빠릿해진 윈도우 환경을 경험하실 수 있을 겁니다.

Window11 전체 서비스 기능에 대한 설명이 궁금하신 분들을 위해 ⬇️⬇️

2026.04.21 - [까먹음 방지.zip] - Windows 11 전체 서비스 기능 설명 및 상태 설정 총정리

Windows 11 전체 서비스 기능 설명 및 상태 설정 총정리

2026.04.21 - [까먹음 방지.zip] - 윈도우11 서비스 최적화 완벽 가이드: 불필요한 서비스 끄기 추천 목록 윈도우11 서비스 최적화 완벽 가이드: 불필요한 서비스 끄기 추천 목록컴퓨터를 쓰다 보면 어

ssunhy.com

[Java] 람다식(Lambda Expression) 완전 정리 - 문법부터 Stream API 실전 활용까지

zippy — Sun, 19 Apr 2026 01:31:30 +0900

람다 함수(Lambda Expression) 개요
함수형 인터페이스 (Functional Interface)
메서드 참조 (Method Reference)
Stream API와 람다
클로저와 변수 캡처
함수 조합 (Function Composition)
실전 예제
기본형 특화 스트림
디버깅 및 주의사항
java.util.function 전체 인터페이스 요약
결론 및 베스트 프랙티스

Java 8부터 도입된 람다 표현식은 익명 함수를 간결하게 작성할 수 있는 문법으로, Stream API와 결합해 함수형 프로그래밍 스타일을 Java에 도입한 핵심 기능입니다. 이 글에서는 람다의 기본 문법부터 실전 활용까지 완전하게 정리합니다.

1. 람다 함수(Lambda Expression) 개요

람다 함수란? 익명 함수를 간결하게 작성하는 문법으로, Java 8부터 도입되었습니다. 함수형 인터페이스의 단 하나의 추상 메서드를 구현하며, 병렬 처리와 Stream API와 함께 함수형 프로그래밍 스타일을 지원합니다.

기본 문법

(파라미터) -> {구현 로직}

// 예시
(int x, int y) -> { return x + y; }
s -> s.length()
() -> Math.random()

문법 변형 정리

형태	설명	예시
`(x, y) -> x + y`	파라미터 2개, 반환문 1줄	`(a, b) -> *`
`x -> *`	파라미터 1개 (괄호 생략 가능)	`n -> n + 1`
`() -> 42`	파라미터 없음	`() -> System.currentTimeMillis()`
`(x) -> { ... return x; }`	복수 로직 (블록 사용)	멀티라인 처리

주요 특징

간결성: 익명 클래스보다 훨씬 짧은 코드
함수형 인터페이스 필요: @FunctionalInterface를 가진 인터페이스 대상
타입 추론: 컴파일러가 자동으로 파라미터/반환 타입 추론
클로저: 외부 변수 접근 가능 (단, final 또는 effectively final)

2. 함수형 인터페이스 (Functional Interface)

정확히 1개의 추상 메서드를 가지는 인터페이스를 함수형 인터페이스라고 합니다. @FunctionalInterface 어노테이션으로 표시하는 것을 권장하며, 람다 표현식의 대상 타입 역할을 합니다.

@FunctionalInterface
public interface MyFunction {
    int apply(int x);  // 추상 메서드 1개만
}

MyFunction f = x ->  * ;
System.out.println(f.apply(5));  // 10

Function 계열: 입력 값을 받아 출력 값을 반환

인터페이스	메서드	설명	예시
`Function<T, R>`	`R apply(T t)`	T → R 변환	`Function<String, Integer> f = String::length;`
`BiFunction<T, U, R>`	`R apply(T t, U u)`	입력 2개 → 1개 결과	`(a, b) -> a + b`
`UnaryOperator<T>`	`T apply(T t)`	T → T (같은 타입)	`x -> *`
`BinaryOperator<T>`	`T apply(T t1, T t2)`	(T, T) → T	`(a, b) -> Math.max(a, b)`

기본형 특화형: IntFunction<R>, LongFunction<R>, DoubleFunction<R> (int/long/double 입력), ToIntFunction<T>, ToLongFunction<T>, ToDoubleFunction<T> (각 기본형으로 반환), IntToDoubleFunction, LongToIntFunction 등 기본형 간 변환을 지원합니다.

Predicate 계열: 입력값에 대해 조건을 검사하고 boolean을 반환

인터페이스	메서드	설명	예시
`Predicate<T>`	`boolean test(T t)`	T에 대한 조건 판단	`s -> s.isEmpty()`
`BiPredicate<T, U>`	`boolean test(T t, U u)`	입력 2개 조건 판단	`(a, b) -> a.equals(b)`
`IntPredicate` 등	`boolean test(XXX)`	기본형 조건 판단	`i -> i > 10`

Consumer 계열: 입력값을 받아 처리만 하고 반환 없음 (void)

인터페이스	메서드	설명	예시
`Consumer<T>`	`void accept(T t)`	T 처리 (결과 없음)	`s -> System.out.println(s)`
`BiConsumer<T, U>`	`void accept(T t, U u)`	입력 2개 처리	`(k, v) -> map.put(k, v)`
`IntConsumer` 등	`void accept(XXX)`	기본형 처리	`i -> total += i`
`ObjIntConsumer<T>`	`void accept(T obj, int i)`	객체 + int 처리	`(obj, i) -> obj.setAge(i)`

Supplier 계열: 입력 없이 값을 제공(공급)

인터페이스	메서드	설명	예시
`Supplier<T>`	`T get()`	T 타입 값 제공	`() -> new Random().nextInt()`
`BooleanSupplier`	`boolean getAsBoolean()`	boolean 값 제공	`() -> true`
`IntSupplier` 등	`XXX getAsXXX()`	기본형 값 제공	`() -> System.currentTimeMillis()`

3. 메서드 참조 (Method Reference)

메서드 참조는 람다식을 더 간결하게 표현하는 방법으로, 대상::메서드이름 형태로 사용합니다.

종류	문법	람다식 대체	예시
정적 메서드 참조	`ClassName::staticMethod`	`(x) -> ClassName.staticMethod(x)`	`Integer::parseInt`
인스턴스 메서드 참조	`instance::method`	`() -> instance.method()`	`System.out::println`
클래스 메서드 참조	`ClassName::instanceMethod`	`(obj) -> obj.toString()`	`String::length`
생성자 참조	`ClassName::new`	`() -> new ClassName()`	`ArrayList::new`

// 정적 메서드 참조
Function<String, Integer> f1 = Integer::parseInt;
int num = f1.apply("123");  // 123

// 인스턴스 메서드 참조
List<String> list = List.of("a", "b", "c");
list.forEach(System.out::println);

// 클래스 메서드 참조
Function<String, Integer> f2 = String::length;
System.out.println(f2.apply("hello"));  // 5

// 생성자 참조
Supplier<ArrayList> s = ArrayList::new;
ArrayList<String> arr = s.get();

4. Stream API와 람다

Stream API는 람다 표현식과 함께 사용될 때 가장 강력한 효과를 발휘합니다.

filter → Predicate
map → Function
forEach → Consumer
reduce → BinaryOperator

List<Integer> numbers = List.of(1, 2, 3, 4, 5);

// filter: Predicate 사용
Stream<Integer> filtered = numbers.stream()
                                  .filter(n -> n > 2);

// map: Function 사용
Stream<Integer> mapped = numbers.stream()
                               .map(n ->  * );

// forEach: Consumer 사용
numbers.stream()
       .forEach(System.out::println);

// reduce: BinaryOperator 사용
int sum = numbers.stream()
                 .reduce(0, (a, b) -> a + b);

자주 사용되는 패턴

List<String> names = List.of("Java", "Spring", "Lambda");

// 필터링 및 변환
List<Integer> lengths = names.stream()
                             .filter(s -> s.length() > 4)
                             .map(String::length)
                             .toList();

// 조건 확인
boolean hasEmpty = names.stream()
                        .anyMatch(s -> s.isEmpty());

// 누적 계산
String result = names.stream()
                     .reduce("", (a, b) -> a + ", " + b);

5. 클로저와 변수 캡처

람다식은 외부 스코프의 변수에 접근할 수 있습니다. 단, 접근 가능한 변수는 effectively final(선언 후 값이 변하지 않는 변수) 또는 명시적 final 변수여야 하며, 람다식 내에서 외부 변수를 직접 변경하는 것은 불가능합니다.

int multiplier = 10;  // effectively final
Function<Integer, Integer> f = x ->  * ultiplier;
System.out.println(f.apply(5));  // 50

int x = 5;
// x = 10;  // 컴파일 에러! effectively final 위반

Function<Integer, Integer> f2 = y -> x + y;
System.out.println(f2.apply(3));  // 8

⚠️ 주의: 외부 변수를 람다 내에서 재할당하면 컴파일 에러가 발생합니다. 변경 가능한 상태가 필요하다면 AtomicInteger 등의 래퍼 클래스를 사용하세요.

6. 함수 조합 (Function Composition)

함수형 인터페이스의 디폴트 메서드를 이용하면 여러 함수를 조합할 수 있습니다.

Function의 조합

Function<Integer, Integer> multiply = x ->  * ;
Function<Integer, Integer> addTen = x -> x + 10;

// andThen: 먼저 실행 후 결과를 다음 함수에 전달
Function<Integer, Integer> combined1 = multiply.andThen(addTen);
System.out.println(combined1.apply(5));  // ( * ) + 10 = 20

// compose: 먼저 실행할 함수를 뒤에 명시
Function<Integer, Integer> combined2 = addTen.compose(multiply);
System.out.println(combined2.apply(5));  // ( * ) + 10 = 20

Predicate의 조합

Predicate<String> isLong = s -> s.length() > 5;
Predicate<String> isEmpty = String::isEmpty;

// and, or, negate
Predicate<String> combined = isLong.and(s -> s.contains("a"));
System.out.println(combined.test("banana"));  // true

Predicate<String> negated = isEmpty.negate();
System.out.println(negated.test("hello"));  // true

7. 실전 예제

7.1 리스트 필터링 및 변환

List<String> words = List.of("hello", "world", "java", "stream");

// 길이 4 이상인 단어들을 대문자로 변환
List<String> result = words.stream()
                           .filter(w -> w.length() >= 4)
                           .map(String::toUpperCase)
                           .toList();
// [HELLO, WORLD, STREAM]

7.2 맵 순회 및 처리

Map<String, Integer> scores = Map.of("Alice", 90, "Bob", 85, "Charlie", 95);

// 80점 이상 사람만 출력
scores.entrySet().stream()
      .filter(entry -> entry.getValue() >= 80)
      .forEach(entry -> System.out.println(entry.getKey() + ": " + entry.getValue()));

7.3 데이터 수집 및 통계

List<Integer> numbers = List.of(10, 20, 30, 40, 50);

// 합계
int sum = numbers.stream().reduce(0, (a, b) -> a + b);

// 평균
double average = numbers.stream()
                        .mapToDouble(n -> n)
                        .average()
                        .orElse(0.0);

// 최대값
int max = numbers.stream()
                 .reduce(Integer.MIN_VALUE, Math::max);

7.4 그룹화 및 분류

List<String> items = List.of("apple", "banana", "apricot", "blueberry");

// 첫 글자별로 그룹화
Map<Character, List<String>> grouped = items.stream()
        .collect(Collectors.groupingBy(s -> s.charAt(0)));
// {a=[apple, apricot], b=[banana, blueberry]}

8. 기본형 특화 스트림

기본형 값을 처리할 때 박싱(Boxing) 오버헤드를 제거하기 위해 기본형 특화 스트림을 사용합니다.

클래스	설명	생성	활용
`IntStream`	int 값 스트림	`IntStream.range(0, 10)`	`sum()`, `average()`, `max()`
`LongStream`	long 값 스트림	`LongStream.range(0L, 100L)`	대용량 숫자 처리
`DoubleStream`	double 값 스트림	`DoubleStream.of(1.0, 2.5, 3.7)`	부동소수점 계산

// int 범위로 스트림 생성
int sum = IntStream.range(1, 11).sum();  // 55

// double 값들의 평균
double avg = DoubleStream.of(10.5, 20.3, 15.8).average().orElse(0.0);

// 조건 필터링
long count = IntStream.range(1, 100)
                      .filter(n -> n % 2 == 0)
                      .count();  // 49 (짝수 개수)

9. 디버깅 및 주의사항

람다식 디버깅 시 peek()을 활용하면 스트림 파이프라인 중간 값을 확인할 수 있습니다.

List<Integer> numbers = List.of(1, 2, 3, 4, 5);
numbers.stream()
       .peek(n -> System.out.println("Processing: " + n))
       .filter(n -> n > 2)
       .peek(n -> System.out.println("After filter: " + n))
       .forEach(System.out::println);

주요 주의사항

Side Effect 주의: 람다식에서 외부 상태 변경을 피할 것
Effectively Final: 외부 변수 값 변경 시 컴파일 에러 발생
Null 처리: null 파라미터 체크 필수
병렬 스트림: parallel() 사용 시 thread-safe 고려

10. java.util.function 전체 인터페이스 요약

Function 계열 (입력 → 출력)

Function<T, R>, BiFunction<T, U, R>, UnaryOperator<T>, BinaryOperator<T>, IntFunction<R>, LongFunction<R>, DoubleFunction<R>, ToIntFunction<T>, ToLongFunction<T>, ToDoubleFunction<T>, ToIntBiFunction<T, U>, ToLongBiFunction<T, U>, ToDoubleBiFunction<T, U>, IntToDoubleFunction, IntToLongFunction, LongToIntFunction, LongToDoubleFunction, DoubleToIntFunction, DoubleToLongFunction, IntUnaryOperator, LongUnaryOperator, DoubleUnaryOperator, IntBinaryOperator, LongBinaryOperator, DoubleBinaryOperator

Predicate 계열 (입력 → boolean)

Predicate<T>, BiPredicate<T, U>, IntPredicate, LongPredicate, DoublePredicate

Consumer 계열 (입력 → void)

Consumer<T>, BiConsumer<T, U>, IntConsumer, LongConsumer, DoubleConsumer, ObjIntConsumer<T>, ObjLongConsumer<T>, ObjDoubleConsumer<T>

Supplier 계열 (void → 출력)

Supplier<T>, BooleanSupplier, IntSupplier, LongSupplier, DoubleSupplier

11. 결론 및 베스트 프랙티스

✅ 람다식을 사용하면 좋은 경우

Stream API와 함께 사용할 때
간단한 처리 로직 (1~3줄)
이벤트 핸들러, 콜백 함수
Optional, CompletableFuture 활용 시

람다식을 피해야 하는 경우

복잡한 다중 라인 로직: 일반 메서드로 추출
Side effect가 있는 작업
재사용 가능한 로직: 메서드로 분리

코드 가독성 예시

❌ 나쁜 예: 복잡한 람다 (한 줄에 몰아넣기)

list.stream().filter(x -> x > 5 && x < 20 && x % 2 == 0).map(x ->  * ).forEach(System.out::println);

✅ 좋은 예: 의도가 명확한 스타일

list.stream()
    .filter(x -> x > 5 && x < 20)
    .filter(x -> x % 2 == 0)
    .map(x ->  * )
    .forEach(System.out::println);

핵심 정리: Java 람다 표현식은 단순한 문법 설탕이 아니라, 함수형 프로그래밍 패러다임을 Java에 녹여낸 강력한 도구입니다. Stream API, Optional, CompletableFuture 등과 함께 익혀두면 코드 품질과 생산성을 크게 높일 수 있습니다.

작성일: 2026년 1월 15일 | 대상: Java 8+ 개발자

[Java] java.util.function 함수형 인터페이스 종류 완벽 정리 (Consumer, Supplier, Function, Predicate)

zippy — Sun, 19 Apr 2026 01:25:38 +0900

☕ java.util.function 패키지 완벽 정리

Java 8부터 도입된 java.util.function 패키지는 람다식과 메서드 참조를 활용한 함수형 프로그래밍을 지원하는 다양한 함수형 인터페이스를 제공합니다. 이 글에서는 각 인터페이스의 역할과 사용법을 한눈에 정리합니다.

함수형 인터페이스란?
기본 함수형 인터페이스
이항(Binary) 함수형 인터페이스
단항(Unary) 연산자
정수 타입(int) 특화 인터페이스
롱 타입(long) 특화 인터페이스
더블 타입(double) 특화 인터페이스
Boolean 특화 인터페이스
반환값 특화 인터페이스
객체-기본타입 혼합 인터페이스
사용 예시
주요 특징 정리
마무리

1. 함수형 인터페이스란?

함수형 인터페이스(Functional Interface)란 단 하나의 추상 메서드만을 가지는 인터페이스입니다. @FunctionalInterface 어노테이션을 붙여 명시적으로 선언하며, 람다식 또는 메서드 참조로 간결하게 구현할 수 있습니다. Java의 Stream API와도 긴밀하게 연동되어 실무에서 매우 폭넓게 사용됩니다.

✅ 2. 기본 함수형 인터페이스

가장 기본이 되는 4가지 인터페이스입니다. 대부분의 함수형 인터페이스는 이 4가지를 기반으로 확장됩니다.

인터페이스	제네릭 타입	설명
Consumer<T>	<T>	단일 입력 인수를 받고 결과를 반환하지 않는 작업을 나타냅니다.
Supplier<T>	<T>	결과를 공급하는 작업을 나타냅니다. (입력 없음)
Function<T,R>	<T,R>	한 개의 인수를 받아서 결과를 생성하는 함수를 나타냅니다.
Predicate<T>	<T>	한 개의 인수에 대한 boolean 값 함수(조건)를 나타냅니다.

✅ 3. 이항(Binary) 함수형 인터페이스

두 개의 인수를 받아 처리하는 인터페이스입니다.

인터페이스	제네릭 타입	설명
BiConsumer<T,U>	<T,U>	두 개의 입력 인수를 받고 결과를 반환하지 않는 작업을 나타냅니다.
BiFunction<T,U,R>	<T,U,R>	두 개의 인수를 받아서 결과를 생성하는 함수를 나타냅니다.
BiPredicate<T,U>	<T,U>	두 개의 인수에 대한 boolean 값 함수(조건)를 나타냅니다.
BinaryOperator<T>	<T>	동일한 타입의 두 개 피연산자에 대한 작업을 나타내며, 같은 타입의 결과를 생성합니다.

✅ 4. 단항(Unary) 연산자

하나의 피연산자를 받아 동일한 타입의 결과를 반환하는 연산자 인터페이스입니다.

인터페이스	제네릭 타입	설명
UnaryOperator<T>	<T>	단일 피연산자에 대한 작업을 나타내며, 피연산자와 같은 타입의 결과를 생성합니다.
IntUnaryOperator	-	int 피연산자에 대한 작업을 나타내며, int 결과를 생성합니다.
LongUnaryOperator	-	long 피연산자에 대한 작업을 나타내며, long 결과를 생성합니다.
DoubleUnaryOperator	-	double 피연산자에 대한 작업을 나타내며, double 결과를 생성합니다.

✅ 5. 정수 타입(int) 특화 인터페이스

기본 타입 int에 특화된 인터페이스로, 박싱/언박싱 오버헤드 없이 성능 최적화를 제공합니다.

인터페이스	제네릭 타입	설명
IntConsumer	-	단일 int 값 인수를 받고 결과를 반환하지 않는 작업을 나타냅니다.
IntSupplier	-	int 값의 결과를 공급하는 작업을 나타냅니다.
IntFunction<R>	<R>	int 값 인수를 받아서 결과를 생성하는 함수를 나타냅니다.
IntPredicate	-	단일 int 값 인수에 대한 boolean 값 함수(조건)를 나타냅니다.
IntBinaryOperator	-	두 개의 int 값 피연산자에 대한 작업을 나타내며, int 결과를 생성합니다.
IntToDoubleFunction	-	int 값 인수를 받아서 double 값 결과를 생성하는 함수를 나타냅니다.
IntToLongFunction	-	int 값 인수를 받아서 long 값 결과를 생성하는 함수를 나타냅니다.

✅ 6. 롱 타입(long) 특화 인터페이스

기본 타입 long에 특화된 인터페이스입니다.

인터페이스	제네릭 타입	설명
LongConsumer	-	단일 long 값 인수를 받고 결과를 반환하지 않는 작업을 나타냅니다.
LongSupplier	-	long 값의 결과를 공급하는 작업을 나타냅니다.
LongFunction<R>	<R>	long 값 인수를 받아서 결과를 생성하는 함수를 나타냅니다.
LongPredicate	-	단일 long 값 인수에 대한 boolean 값 함수(조건)를 나타냅니다.
LongBinaryOperator	-	두 개의 long 값 피연산자에 대한 작업을 나타내며, long 결과를 생성합니다.
LongToDoubleFunction	-	long 값 인수를 받아서 double 값 결과를 생성하는 함수를 나타냅니다.
LongToIntFunction	-	long 값 인수를 받아서 int 값 결과를 생성하는 함수를 나타냅니다.

✅ 7. 더블 타입(double) 특화 인터페이스

기본 타입 double에 특화된 인터페이스입니다.

인터페이스	제네릭 타입	설명
DoubleConsumer	-	단일 double 값 인수를 받고 결과를 반환하지 않는 작업을 나타냅니다.
DoubleSupplier	-	double 값의 결과를 공급하는 작업을 나타냅니다.
DoubleFunction<R>	<R>	double 값 인수를 받아서 결과를 생성하는 함수를 나타냅니다.
DoublePredicate	-	단일 double 값 인수에 대한 boolean 값 함수(조건)를 나타냅니다.
DoubleBinaryOperator	-	두 개의 double 값 피연산자에 대한 작업을 나타내며, double 결과를 생성합니다.
DoubleToIntFunction	-	double 값 인수를 받아서 int 값 결과를 생성하는 함수를 나타냅니다.
DoubleToLongFunction	-	double 값 인수를 받아서 long 값 결과를 생성하는 함수를 나타냅니다.

✅ 8. Boolean 특화 인터페이스

인터페이스	제네릭 타입	설명
BooleanSupplier	-	boolean 값의 결과를 공급하는 작업을 나타냅니다.

✅ 9. 반환값 특화 인터페이스

입력 타입에 관계없이 특정 기본 타입으로 결과를 반환하는 인터페이스입니다.

인터페이스	제네릭 타입	설명
ToDoubleFunction<T>	<T>	단일 인수를 받아서 double 값 결과를 생성하는 함수를 나타냅니다.
ToDoubleBiFunction<T,U>	<T,U>	두 개의 인수를 받아서 double 값 결과를 생성하는 함수를 나타냅니다.
ToIntFunction<T>	<T>	단일 인수를 받아서 int 값 결과를 생성하는 함수를 나타냅니다.
ToIntBiFunction<T,U>	<T,U>	두 개의 인수를 받아서 int 값 결과를 생성하는 함수를 나타냅니다.
ToLongFunction<T>	<T>	단일 인수를 받아서 long 값 결과를 생성하는 함수를 나타냅니다.
ToLongBiFunction<T,U>	<T,U>	두 개의 인수를 받아서 long 값 결과를 생성하는 함수를 나타냅니다.

✅ 10. 객체-기본타입 혼합 인터페이스

객체 타입과 기본 타입 인수를 함께 받는 Consumer 계열 인터페이스입니다.

인터페이스	제네릭 타입	설명
ObjIntConsumer<T>	<T>	객체 값과 int 값 인수를 받고 결과를 반환하지 않는 작업을 나타냅니다.
ObjLongConsumer<T>	<T>	객체 값과 long 값 인수를 받고 결과를 반환하지 않는 작업을 나타냅니다.
ObjDoubleConsumer<T>	<T>	객체 값과 double 값 인수를 받고 결과를 반환하지 않는 작업을 나타냅니다.

11. 사용 예시

Consumer 예시

입력값을 받아 소비(출력 등)하고 반환값 없음

Consumer<String> print = System.out::println;
print.accept("Hello World");  // 출력: Hello World

Supplier 예시

인수 없이 값을 공급

Supplier<String> greeting = () -> "Hello, Java!";
System.out.println(greeting.get());  // 출력: Hello, Java!

Function 예시

입력을 받아 변환 후 반환

Function<Integer, Integer> square = x ->  * ;
int result = square.apply(5);  // 결과: 25

Predicate 예시

조건을 검사하여 boolean 반환

Predicate<Integer> isPositive = x -> x > 0;
boolean result = isPositive.test(5);  // 결과: true

BiFunction 예시

두 인수를 받아 결과 생성

BiFunction<Integer, Integer, Integer> add = (a, b) -> a + b;
int result = add.apply(3, 4);  // 결과: 7

UnaryOperator 예시

입력과 동일한 타입으로 반환

UnaryOperator<String> toUpper = String::toUpperCase;
String result = toUpper.apply("hello");  // 결과: HELLO

BinaryOperator 예시

동일 타입 두 인수를 받아 같은 타입 반환

BinaryOperator<Integer> multiply = (a, b) ->  * ;
int result = multiply.apply(3, 4);  // 결과: 12

⚡ 12. 주요 특징 정리

@FunctionalInterface: 단 하나의 추상 메서드를 가진 인터페이스로, 어노테이션을 통해 컴파일러가 조건을 강제합니다.
람다식 지원: 람다식 또는 메서드 참조로 간결하게 구현할 수 있어 코드 가독성이 향상됩니다.
Stream API 호환: filter(), map(), forEach() 등 스트림 작업에서 광범위하게 사용됩니다.
기본 타입 특화 인터페이스: int, long, double에 특화된 인터페이스를 사용하면 오토박싱/언박싱 오버헤드를 제거하여 성능을 높일 수 있습니다.
조합(Compose) 지원: Function.andThen(), Predicate.and() 등 디폴트 메서드를 통해 함수 합성이 가능합니다.

13. 마무리

java.util.function 패키지의 함수형 인터페이스는 Java 함수형 프로그래밍의 핵심입니다. 처음에는 종류가 많아 헷갈릴 수 있지만, Consumer / Supplier / Function / Predicate 기본 4가지를 확실히 이해하면 나머지 파생 인터페이스도 자연스럽게 익힐 수 있습니다. Stream API와 함께 사용하면 코드를 훨씬 간결하고 읽기 쉽게 작성할 수 있으니 꼭 익혀두시길 권장합니다.

Spring Data JPA Query Methods 키워드 완전 정리 (메서드 이름으로 쿼리 만들기)

zippy — Sun, 19 Apr 2026 01:24:18 +0900

Spring Data JPA Query Methods 키워드 완벽 가이드

Spring Data JPA의 Query Methods(메서드 이름 쿼리)는 메서드 이름만으로 JPQL 쿼리를 자동 생성해주는 강력한 기능입니다. 이 글에서는 주요 키워드를 카테고리별로 체계적으로 정리하고, 실제 사용 예시와 JPQL/SQL 변환까지 한눈에 확인할 수 있도록 정리했습니다.

✅ 핵심 규칙 요약

Query Methods를 사용하기 전에 아래 기본 규칙을 숙지하세요.

기본 형태: findBy + 필드명 + 키워드 + (필드명 + 키워드)...
반환 타입: List<T>, Optional<T>, Page<T>, Slice<T>, Long (count 용)
정렬: OrderBy필드명Asc / OrderBy필드명Desc
페이징: Pageable 파라미터 추가 시 자동 페이징 지원

기준 엔티티 (User)

이 글의 모든 예시는 아래 User 엔티티를 기준으로 작성되었습니다.

@Entity
public class User {
    @Id @GeneratedValue
    private Long id;
    private String name;
    private String email;
    private Integer age;
    private Boolean active;
    private LocalDateTime createdDate;

    @Enumerated(EnumType.STRING)
    private Role role;

    @ManyToOne
    private Department department;
}

1. 논리 연산자 & NULL 체크

카테고리	키워드	설명	Java 메서드 예시	JPQL 변환	SQL 변환
논리	`And`	AND 조건	`findByNameAndAge(String name, Integer age)`	`WHERE u.name = ?1 AND u.age = ?2`	`WHERE name = ? AND age = ?`
논리	`Or`	OR 조건	`findByNameOrEmail(String name, String email)`	`WHERE u.name = ?1 OR u.email = ?2`	`WHERE name = ? OR email = ?`
NULL	`IsNull`	IS NULL	`findByEmailIsNull()`	`WHERE u.email IS NULL`	`WHERE email IS NULL`
NULL	`IsNotNull` / `NotNull`	IS NOT NULL	`findByEmailIsNotNull()`	`WHERE u.email IS NOT NULL`	`WHERE email IS NOT NULL`

2. 비교 연산자

카테고리	키워드	설명	Java 메서드 예시	JPQL 변환	SQL 변환
비교	`LessThan`	< 보다 작은	`findByAgeLessThan(Integer age)`	`WHERE u.age < ?1`	`WHERE age < ?`
비교	`LessThanEqual`	<= 이하	`findByAgeLessThanEqual(Integer age)`	`WHERE u.age <= ?1`	`WHERE age <= ?`
비교	`GreaterThan`	> 보다 큰	`findByAgeGreaterThan(Integer age)`	`WHERE u.age > ?1`	`WHERE age > ?`
비교	`GreaterThanEqual`	>= 이상	`findByAgeGreaterThanEqual(Integer age)`	`WHERE u.age >= ?1`	`WHERE age >= ?`

3. 범위 / 날짜

카테고리	키워드	설명	Java 메서드 예시	JPQL 변환	SQL 변환
범위	`Between`	두 값 사이	`findByAgeBetween(Integer min, Integer max)`	`WHERE u.age BETWEEN ?1 AND ?2`	`WHERE age BETWEEN ? AND ?`
날짜	`After`	특정 시점 이후	`findByCreatedDateAfter(LocalDateTime t)`	`WHERE u.createdDate > ?1`	`WHERE created_date > ?`
날짜	`Before`	특정 시점 이전	`findByCreatedDateBefore(LocalDateTime t)`	`WHERE u.createdDate < ?1`	`WHERE created_date < ?`

4. 문자열 패턴 (LIKE 계열)

카테고리	키워드	설명	Java 메서드 예시	JPQL 변환	SQL 변환
문자열	`Like`	LIKE 그대로 사용	`findByNameLike(String pattern)`	`WHERE u.name LIKE ?1`	`WHERE name LIKE ?`
문자열	`NotLike`	NOT LIKE	`findByNameNotLike(String pattern)`	`WHERE u.name NOT LIKE ?1`	`WHERE name NOT LIKE ?`
문자열	`StartingWith`	접두어 검색 (값%)	`findByNameStartingWith(String prefix)`	`WHERE u.name LIKE ?1%`	`WHERE name LIKE '김%'`
문자열	`EndingWith`	접미어 검색 (%값)	`findByNameEndingWith(String suffix)`	`WHERE u.name LIKE %?1`	`WHERE name LIKE '%동'`
문자열	`Containing`	포함 검색 (%값%)	`findByNameContaining(String keyword)`	`WHERE u.name LIKE %?1%`	`WHERE name LIKE '%길동%'`
문자열	`IgnoreCase`	대소문자 무시	`findByNameIgnoreCase(String name)`	`WHERE UPPER(u.name) = UPPER(?1)`	`WHERE UPPER(name) = UPPER(?)`

IgnoreCase 조합 팁: IgnoreCase는 다른 키워드와 조합해서 사용할 수 있습니다.
예: findByNameContainingIgnoreCase(String keyword) → WHERE UPPER(name) LIKE UPPER('%keyword%')

5. 집합 연산 (IN 계열)

카테고리	키워드	설명	Java 메서드 예시	JPQL 변환	SQL 변환
집합	`In`	여러 값 중 하나	`findByRoleIn(List<Role> roles)`	`WHERE u.role IN ?1`	`WHERE role IN (?, ?, ?)`
집합	`NotIn`	여러 값이 아닌 것	`findByRoleNotIn(List<Role> roles)`	`WHERE u.role NOT IN ?1`	`WHERE role NOT IN (?, ?, ?)`

6. 정렬 (OrderBy)

카테고리	키워드	설명	Java 메서드 예시	JPQL 변환	SQL 변환
정렬	`OrderBy`	특정 필드 기준 정렬	`findByAgeOrderByCreatedDateDesc(Integer age)`	`WHERE u.age = ?1 ORDER BY u.createdDate DESC`	`WHERE age = ? ORDER BY created_date DESC`
정렬	`Asc`	오름차순	`OrderByNameAsc`	`ORDER BY u.name ASC`	`ORDER BY name ASC`
정렬	`Desc`	내림차순	`OrderByNameDesc`	`ORDER BY u.name DESC`	`ORDER BY name DESC`

⚠️ OrderBy 주의사항: OrderBy는 반드시 조건(WHERE 절) 뒤에 붙는 형식으로 사용합니다.
예: findByDepartmentOrderByCreatedDateDesc(Department dept)

7. 불린(Boolean) 조건

카테고리	키워드	설명	Java 메서드 예시	JPQL 변환	SQL 변환
불린	`True`	= true	`findByActiveTrue()`	`WHERE u.active = true`	`WHERE active = true`
불린	`False`	= false	`findByActiveFalse()`	`WHERE u.active = false`	`WHERE active = false`

8. 부정 / 기타

카테고리	키워드	설명	Java 메서드 예시	JPQL / SQL 예시
부정	`Not`	값이 다른 경우 (<>)	`findByNameNot(String name)`	`WHERE u.name <> ?1` / `WHERE name <> ?`
고유	`Distinct`	중복 제거	`findDistinctByEmail(String email)`	`SELECT DISTINCT u.email FROM User u WHERE ...`
순위	`First` / `Top`	상위 N개만	`findFirstByOrderByCreatedDateDesc()` `findTop5ByAgeGreaterThan(Integer age)`	`ORDER BY ... + LIMIT` (DB 페이징 사용)

실전용 UserRepository 예시 코드

위 표의 키워드를 실제로 사용하는 UserRepository 전체 예시입니다. 복사해서 Spring Boot 프로젝트에 바로 적용해 보세요.

public interface UserRepository extends JpaRepository<User, Long> {

    // ---------- 기본 / 논리 ----------
    List<User> findByName(String name);
    List<User> findByNameAndAge(String name, Integer age);
    List<User> findByNameOrEmail(String name, String email);

    // ---------- NULL ----------
    List<User> findByEmailIsNull();
    List<User> findByEmailIsNotNull();

    // ---------- 비교 ----------
    List<User> findByAgeLessThan(Integer age);
    List<User> findByAgeLessThanEqual(Integer age);
    List<User> findByAgeGreaterThan(Integer age);
    List<User> findByAgeGreaterThanEqual(Integer age);

    // ---------- 범위 / 날짜 ----------
    List<User> findByAgeBetween(Integer min, Integer max);
    List<User> findByCreatedDateAfter(LocalDateTime t);
    List<User> findByCreatedDateBefore(LocalDateTime t);

    // ---------- 문자열 패턴 ----------
    List<User> findByNameLike(String pattern);                 // 직접 % 포함
    List<User> findByNameNotLike(String pattern);
    List<User> findByNameStartingWith(String prefix);          // prefix%
    List<User> findByNameEndingWith(String suffix);            // %suffix
    List<User> findByNameContaining(String keyword);           // %keyword%
    List<User> findByNameContainingIgnoreCase(String keyword); // 대소문자 무시

    // ---------- 집합(IN) ----------
    List<User> findByRoleIn(Collection<Role> roles);
    List<User> findByRoleNotIn(Collection<Role> roles);

    // ---------- 정렬 ----------
    List<User> findByDepartmentOrderByCreatedDateDesc(Department dept);
    List<User> findByAgeOrderByNameAsc(Integer age);

    // ---------- 불린 ----------
    List<User> findByActiveTrue();
    List<User> findByActiveFalse();

    // ---------- 부정 / 기타 ----------
    List<User> findByNameNot(String name);
    List<User> findDistinctByEmail(String email);
    Optional<User> findFirstByOrderByCreatedDateDesc();
    List<User> findTop5ByAgeGreaterThan(Integer age);
}

⚡ 사용 패턴 빠른 참조표

목적	사용 키워드
단순 검색	`findBy필드명`, `findBy필드명And다른필드`
문자열 검색	`Containing`, `StartingWith`, `EndingWith`, `Like`
날짜/숫자 범위	`Between`, `LessThan`, `GreaterThanEqual`
정렬	`OrderBy필드명Asc` / `Desc`
집합 조건	`In`, `NotIn`
상태값 (Boolean)	`True`, `False`
대소문자 무시	`IgnoreCase` 조합
NULL 체크	`IsNull`, `IsNotNull`
상위 N개	`First`, `Top`
중복 제거	`Distinct`

이 포스팅 하나만 북마크해두면, Spring Data JPA의 Query Method 키워드를 개발 중 언제든 빠르게 참조할 수 있습니다. 실무에서 자주 쓰이는 패턴 위주로 구성했으니 바로 적용해 보세요!

[JPA] JPQL 문법 완전정복 - 실전 예제 30가지 총정리

zippy — Sun, 19 Apr 2026 01:09:47 +0900

JPQL 실전 예제 30선: 문법 완전 정복 가이드

JPQL(Java Persistence Query Language)은 JPA에서 데이터를 조회하기 위한 객체지향 쿼리 언어입니다. SQL과 유사하지만 테이블이 아닌 엔티티(Entity)와 속성(Field)을 대상으로 동작하는 것이 핵심 차이점입니다. 이 글에서는 실무에서 바로 사용할 수 있는 30가지 실전 예제를 통해 JPQL 문법을 완전히 정복해 봅니다.

1. JPQL 기본 문법 (SQL과 비교)

JPQL은 SQL과 비슷하지만 엔티티와 속성을 대상으로 합니다. 아래 표에서 주요 차이점을 확인하세요.

JPQL 특징	SQL	JPQL	설명
테이블 → 엔티티	`user`	`User u`	테이블명 대신 엔티티 클래스명 사용
컬럼 → 속성	`name`	`u.name`	컬럼명 대신 엔티티 필드명 사용
별칭	`user u`	`User u`	AS 생략 가능, 필수는 아님
와일드카드	`SELECT *`	`SELECT u`	* 대신 별칭 사용
조인	`JOIN dept`	`JOIN u.department`	객체 관계를 따라 조인

2. 기본 SELECT 쿼리 (예제 1~10)

예제 1: 전체 조회

상황: 모든 사용자를 조회하고 싶을 때

JPQL: SELECT u FROM User u

@Query("SELECT u FROM User u")
List<User> findAllUsers();

⚙️ SQL 변환: SELEC * ROM user
✅ 결과: 모든 User 엔티티 리스트
언제 사용: 관리자 화면에서 전체 회원 목록을 보여줄 때

예제 2: 특정 컬럼만 조회

상황: 이름과 이메일만 가져오고 싶을 때

JPQL: SELECT u.name, u.email FROM User u

@Query("SELECT u.name, u.email FROM User u")
List<Object[]> findNamesAndEmails();

⚙️ SQL 변환: SELECT name, email FROM user
✅ 결과: Object[] 리스트, [0]=name, [1]=email
언제 사용: 통계 화면에서 최소한의 데이터만 빠르게 조회할 때

예제 3: NEW DTO로 조회

상황: DTO로 바로 변환해서 받고 싶을 때

JPQL: SELECT NEW com.example.UserDto(u.id, u.name, u.email) FROM User u

@Query("SELECT NEW com.example.UserDto(u.id, u.name, u.email) FROM User u")
List<UserDto> findUserDtos();

⚙️ SQL 변환: SELECT id, name, email FROM user
✅ 결과: UserDto 리스트
언제 사용: API 응답용 DTO를 JPQL에서 바로 생성할 때

예제 4: DISTINCT로 중복 제거

상황: 중복된 이메일을 제거하고 싶을 때

JPQL: SELECT DISTINCT u.email FROM User u

@Query("SELECT DISTINCT u.email FROM User u")
List<String> findDistinctEmails();

⚙️ SQL 변환: SELECT DISTINCT email FROM user
✅ 결과: 중복 없는 이메일 문자열 리스트
언제 사용: 중복 데이터 제거 후 통계 분석할 때

예제 5: TOP/LIMIT (페이징)

상황: 최근 가입한 5명만 조회하고 싶을 때

JPQL: SELECT u FROM User u ORDER BY u.createdDate DESC

@Query("SELECT u FROM User u ORDER BY u.createdDate DESC")
List<User> findRecentUsers(Pageable pageable);

// 사용: findRecentUsers(PageRequest.of(0, 5))

⚙️ SQL 변환: SELEC * ROM user ORDER BY created_date DESC LIMIT 5
✅ 결과: 최근 5명의 User 리스트
언제 사용: 대시보드에서 최신 가입자를 보여줄 때

예제 6: COUNT 집계

상황: 전체 사용자 수를 세고 싶을 때

JPQL: SELECT COUNT(u) FROM User u

@Query("SELECT COUNT(u) FROM User u")
Long countAllUsers();

⚙️ SQL 변환: SELECT COUNT(*) FROM user
✅ 결과: 전체 사용자 수 (Long)
언제 사용: 관리자 대시보드에서 통계 표시할 때

예제 7: SUM 집계

상황: 모든 사용자 나이의 합을 구하고 싶을 때

JPQL: SELECT SUM(u.age) FROM User u

@Query("SELECT SUM(u.age) FROM User u")
Long sumAllAges();

⚙️ SQL 변환: SELECT SUM(age) FROM user
✅ 결과: 나이 총합 (Long)
언제 사용: 평균 나이 계산 전 단계로 사용할 때

예제 8: AVG, MAX, MIN 집계

상황: 나이의 평균, 최대, 최소를 한 번에 구하고 싶을 때

JPQL: SELECT AVG(u.age), MAX(u.age), MIN(u.age) FROM User u

@Query("SELECT AVG(u.age), MAX(u.age), MIN(u.age) FROM User u")
List<Object[]> findAgeStats();

⚙️ SQL 변환: SELECT AVG(age), MAX(age), MIN(age) FROM user
✅ 결과: [평균, 최대, 최소]가 담긴 Object[]
언제 사용: 통계 대시보드에서 한 번에 여러 지표를 보여줄 때

예제 9: 별칭(AS) 사용

상황: 결과 컬럼명을 명시적으로 지정하고 싶을 때

JPQL: SELECT u.name AS userName, u.email AS userEmail FROM User u

@Query("SELECT u.name AS userName, u.email AS userEmail FROM User u")
List<Object[]> findUserNameAndEmailWithAlias();

⚙️ SQL 변환: SELECT name AS userName, email AS userEmail FROM user
✅ 결과: Object[] 리스트, 별칭으로 접근 가능
언제 사용: 결과 매핑 시 명확한 컬럼명이 필요할 때

예제 10: INDEX 함수 (컬렉션)

상황: List 타입 컬렉션의 특정 인덱스 값을 조회할 때

JPQL: SELECT u FROM User u WHERE INDEX(u.phones) = 0

// User 엔티티에 List<String> phones 필드가 있다고 가정
@Query("SELECT u FROM User u WHERE INDEX(u.phones) = 0")
List<User> findUsersWithFirstPhone();

⚙️ SQL 변환: DB에 따라 다름 (일부 DB는 지원 안 함)
✅ 결과: 첫 번째 전화번호가 있는 User 리스트
언제 사용: 컬렉션 필드의 특정 위치 값을 검색할 때

3. WHERE 조건 쿼리 (예제 11~20)

예제 11: 단순 동등 조건 (=)

상황: 이름이 정확히 "홍길동"인 사용자 찾기

JPQL: SELECT u FROM User u WHERE u.name = :name

@Query("SELECT u FROM User u WHERE u.name = :name")
List<User> findByNameExact(@Param("name") String name);

⚙️ SQL 변환: SELEC * ROM user WHERE name = ?
✅ 결과: 이름이 정확히 일치하는 User 리스트
언제 사용: 로그인 ID나 정확한 값으로 검색할 때

예제 12: 부분 문자열 검색 (LIKE)

상황: 이름에 "길동"이 포함된 사용자 찾기

JPQL: SELECT u FROM User u WHERE u.name LIKE %:keyword%

@Query("SELECT u FROM User u WHERE u.name LIKE %:keyword%")
List<User> findByNameContaining(@Param("keyword") String keyword);

⚙️ SQL 변환: SELEC * ROM user WHERE name LIKE '%길동%'
✅ 결과: 이름에 키워드가 포함된 User 리스트
언제 사용: 검색창에서 부분 검색할 때

예제 13: 시작/끝 문자열 검색

상황: "김"으로 시작하는 이름 찾기

JPQL: SELECT u FROM User u WHERE u.name LIKE :keyword%

@Query("SELECT u FROM User u WHERE u.name LIKE :keyword%")
List<User> findByNameStartingWith(@Param("keyword") String keyword);

⚙️ SQL 변환: SELEC * ROM user WHERE name LIKE '김%'
✅ 결과: "김"으로 시작하는 이름의 User 리스트
언제 사용: 초성 검색이나 성씨로 필터링할 때

예제 14: 범위 조건 (BETWEEN)

상황: 나이가 20세에서 30세 사이인 사용자 찾기

JPQL: SELECT u FROM User u WHERE u.age BETWEEN :minAge AND :maxAge

@Query("SELECT u FROM User u WHERE u.age BETWEEN :minAge AND :maxAge")
List<User> findByAgeBetween(@Param("minAge") int minAge, @Param("maxAge") int maxAge);

⚙️ SQL 변환: SELEC * ROM user WHERE age BETWEEN 20 AND 30
✅ 결과: 해당 나이 범위의 User 리스트
언제 사용: 나이, 가격, 날짜 범위 필터에서 사용할 때

예제 15: 목록 조건 (IN)

상황: 특정 도시 목록에 속한 사용자 찾기

JPQL: SELECT u FROM User u WHERE u.city IN :cities

@Query("SELECT u FROM User u WHERE u.city IN :cities")
List<User> findByCityIn(@Param("cities") List<String> cities);

⚙️ SQL 변환: SELEC * ROM user WHERE city IN ('서울', '부산', '대구')
✅ 결과: 해당 도시에 사는 User 리스트
언제 사용: 체크박스 다중 선택 필터에서 사용할 때

예제 16: NULL 조건 (IS NULL / IS NOT NULL)

상황: 이메일이 등록되지 않은 사용자 찾기

JPQL: SELECT u FROM User u WHERE u.email IS NULL

@Query("SELECT u FROM User u WHERE u.email IS NULL")
List<User> findByEmailIsNull();

// 반대: IS NOT NULL
@Query("SELECT u FROM User u WHERE u.email IS NOT NULL")
List<User> findByEmailIsNotNull();

⚙️ SQL 변환: SELEC * ROM user WHERE email IS NULL
✅ 결과: 이메일이 없는 User 리스트
언제 사용: 미완성 프로필 대상으로 알림을 보낼 때

예제 17: 복합 조건 (AND, OR)

상황: 나이가 25세 이상이고 서울에 사는 사용자 찾기

JPQL: SELECT u FROM User u WHERE u.age >= :age AND u.city = :city

@Query("SELECT u FROM User u WHERE u.age >= :age AND u.city = :city")
List<User> findByAgeAndCity(@Param("age") int age, @Param("city") String city);

⚙️ SQL 변환: SELEC * ROM user WHERE age >= 25 AND city = '서울'
✅ 결과: 두 조건을 동시에 만족하는 User 리스트
언제 사용: 다중 필터 검색 기능 구현 시

예제 18: NOT 조건

상황: 탈퇴하지 않은 활성 사용자만 조회하기

JPQL: SELECT u FROM User u WHERE u.status != :status

@Query("SELECT u FROM User u WHERE u.status != :status")
List<User> findByStatusNot(@Param("status") String status);

// 사용: findByStatusNot("DELETED")

⚙️ SQL 변환: SELEC * ROM user WHERE status != 'DELETED'
✅ 결과: 해당 상태가 아닌 User 리스트
언제 사용: 소프트 딜리트 구현에서 삭제되지 않은 데이터만 조회할 때

예제 19: 날짜 조건

상황: 특정 날짜 이후에 가입한 사용자 찾기

JPQL: SELECT u FROM User u WHERE u.createdDate > :date

@Query("SELECT u FROM User u WHERE u.createdDate > :date")
List<User> findByCreatedDateAfter(@Param("date") LocalDateTime date);

⚙️ SQL 변환: SELEC * ROM user WHERE created_date > ?
✅ 결과: 해당 날짜 이후 가입한 User 리스트
언제 사용: 신규 회원 대상 이벤트 대상자를 뽑을 때

예제 20: LOWER/UPPER 함수 (대소문자 무시 검색)

상황: 이메일을 대소문자 구분 없이 검색하고 싶을 때

JPQL: SELECT u FROM User u WHERE LOWER(u.email) = LOWER(:email)

@Query("SELECT u FROM User u WHERE LOWER(u.email) = LOWER(:email)")
Optional<User> findByEmailIgnoreCase(@Param("email") String email);

⚙️ SQL 변환: SELEC * ROM user WHERE LOWER(email) = LOWER(?)
✅ 결과: 대소문자에 관계없이 일치하는 User
언제 사용: 이메일 로그인, 아이디 중복 체크 시 대소문자를 무시할 때

4. JOIN 및 관계 쿼리 (예제 21~25)

예제 21: INNER JOIN

상황: 부서가 있는 사용자만 조회하기 (부서 정보도 함께)

JPQL: SELECT u FROM User u JOIN u.department d WHERE d.name = :deptName

@Query("SELECT u FROM User u JOIN u.department d WHERE d.name = :deptName")
List<User> findByDepartmentName(@Param("deptName") String deptName);

⚙️ SQL 변환: SELECT u.* FROM user u INNER JOIN department d ON u.dept_id = d.id WHERE d.name = ?
✅ 결과: 해당 부서에 속한 User 리스트
언제 사용: 특정 팀/부서에 속한 직원을 조회할 때

예제 22: LEFT JOIN

상황: 부서가 없는 사용자도 포함하여 조회하기

JPQL: SELECT u FROM User u LEFT JOIN u.department d

@Query("SELECT u FROM User u LEFT JOIN u.department d")
List<User> findAllWithDepartment();

⚙️ SQL 변환: SELECT u.* FROM user u LEFT JOIN department d ON u.dept_id = d.id
✅ 결과: 부서 유무에 관계없이 모든 User 리스트
언제 사용: 부서 미배정 직원까지 포함한 전체 명단을 뽑을 때

예제 23: FETCH JOIN (N+1 문제 해결)

상황: 사용자와 부서 정보를 한 번의 쿼리로 함께 로딩하기

JPQL: SELECT u FROM User u JOIN FETCH u.department

@Query("SELECT u FROM User u JOIN FETCH u.department")
List<User> findAllWithDepartmentFetch();

⚙️ SQL 변환: SELECT u.*, d.* FROM user u INNER JOIN department d ON u.dept_id = d.id
✅ 결과: 부서 정보가 즉시 로딩된 User 리스트 (LazyLoading 방지)
언제 사용: 연관 엔티티를 반드시 함께 사용할 때, N+1 쿼리 문제를 해결할 때

예제 24: 컬렉션 JOIN (일대다)

상황: 특정 주문을 한 사용자 조회 (User - Orders 일대다 관계)

JPQL: SELECT DISTINCT u FROM User u JOIN u.orders o WHERE o.status = :status

@Query("SELECT DISTINCT u FROM User u JOIN u.orders o WHERE o.status = :status")
List<User> findByOrderStatus(@Param("status") String status);

⚙️ SQL 변환: SELECT DISTINCT u.* FROM user u INNER JOIN orders o ON o.user_id = u.id WHERE o.status = ?
✅ 결과: 해당 상태의 주문이 있는 User 리스트 (DISTINCT로 중복 제거)
언제 사용: 특정 행동(주문, 리뷰 등)을 한 사용자를 뽑을 때

예제 25: 서브쿼리 (EXISTS)

상황: 주문 이력이 있는 사용자만 조회하기

JPQL: SELECT u FROM User u WHERE EXISTS (SELECT o FROM Order o WHERE o.user = u)

@Query("SELECT u FROM User u WHERE EXISTS (SELECT o FROM Order o WHERE o.user = u)")
List<User> findUsersWithOrders();

⚙️ SQL 변환: SELEC * ROM user u WHERE EXISTS (SELECT 1 FROM orders o WHERE o.user_id = u.id)
✅ 결과: 주문 이력이 있는 User 리스트
언제 사용: 특정 활동 이력이 있는 사용자만 필터링할 때

5. 정렬 및 그룹 쿼리 (예제 26~30)

예제 26: ORDER BY 다중 정렬

상황: 도시별로 정렬하고, 같은 도시 안에서 나이 순으로 정렬하기

JPQL: SELECT u FROM User u ORDER BY u.city ASC, u.age DESC

@Query("SELECT u FROM User u ORDER BY u.city ASC, u.age DESC")
List<User> findAllOrderByCityAndAge();

⚙️ SQL 변환: SELEC * ROM user ORDER BY city ASC, age DESC
✅ 결과: 도시 오름차순, 나이 내림차순으로 정렬된 User 리스트
언제 사용: 복합 기준으로 리스트를 정렬하여 보여줄 때

예제 27: GROUP BY와 HAVING

상황: 도시별 사용자 수를 구하고, 10명 이상인 도시만 보기

JPQL: SELECT u.city, COUNT(u) FROM User u GROUP BY u.city HAVING COUNT(u) >= :minCount

@Query("SELECT u.city, COUNT(u) FROM User u GROUP BY u.city HAVING COUNT(u) >= :minCount")
List<Object[]> findCityWithMinUsers(@Param("minCount") long minCount);

⚙️ SQL 변환: SELECT city, COUNT(*) FROM user GROUP BY city HAVING COUNT(*) >= 10
✅ 결과: [도시명, 사용자 수] 쌍의 Object[] 리스트
언제 사용: 지역별 통계 리포트, 그룹별 집계 결과를 보여줄 때

예제 28: CASE WHEN (조건부 값 반환)

상황: 나이에 따라 "청년", "중년", "장년" 라벨을 붙이고 싶을 때

JPQL: SELECT u.name, CASE WHEN u.age < 30 THEN '청년' WHEN u.age < 50 THEN '중년' ELSE '장년' END FROM User u

@Query("SELECT u.name, CASE WHEN u.age < 30 THEN '청년' WHEN u.age < 50 THEN '중년' ELSE '장년' END FROM User u")
List<Object[]> findUsersWithAgeGroup();

⚙️ SQL 변환: SELECT name, CASE WHEN age < 30 THEN '청년' WHEN age < 50 THEN '중년' ELSE '장년' END FROM user
✅ 결과: [이름, 나이 그룹] 쌍의 Object[] 리스트
언제 사용: 분류 라벨링이나 조건부 표시 값이 필요할 때

예제 29: 서브쿼리 (IN 절 활용)

상황: VIP 등급인 사용자들의 최근 주문만 조회하기

JPQL: SELECT o FROM Order o WHERE o.user IN (SELECT u FROM User u WHERE u.grade = :grade)

@Query("SELECT o FROM Order o WHERE o.user IN (SELECT u FROM User u WHERE u.grade = :grade)")
List<Order> findOrdersByUserGrade(@Param("grade") String grade);

⚙️ SQL 변환: SELEC * ROM orders WHERE user_id IN (SELECT id FROM user WHERE grade = 'VIP')
✅ 결과: 특정 등급 사용자들의 Order 리스트
언제 사용: 특정 조건의 사용자와 연관된 데이터를 한 번에 조회할 때

예제 30: 네이티브 쿼리 혼용 (nativeQuery)

상황: JPQL로 표현하기 어려운 DB 전용 함수나 힌트를 써야 할 때

SQL (Native): SELEC * ROM user WHERE MATCH(name, email) AGAINST (?)

@Query(value = "SELEC * ROM user WHERE MATCH(name, email) AGAINST (:keyword)", nativeQuery = true)
List<User> findByFullText(@Param("keyword") String keyword);

⚙️ SQL 변환: 그대로 실행 (DB 종속적)
✅ 결과: 전문 검색(Full-Text Search)에 매칭된 User 리스트
언제 사용: MySQL FULLTEXT 인덱스, Oracle 힌트 등 DB 전용 기능이 필요할 때

JPQL vs Spring Data JPA 메서드 비교

JPQL과 Spring Data JPA의 메서드 쿼리는 함께 사용됩니다. 간단한 조건은 메서드 이름으로, 복잡한 조건은 JPQL @Query로 작성하는 것이 실무 표준입니다.

상황	추천 방법	예시
단순 필드 조회	메서드 이름	`findByName(String name)`
복합 조건 조회	@Query JPQL	`@Query("SELECT u FROM User u WHERE ...")`
DTO 변환 조회	@Query JPQL + NEW	`SELECT NEW dto(...) FROM ...`
DB 전용 함수	nativeQuery=true	`@Query(value="...", nativeQuery=true)`
N+1 문제 해결	FETCH JOIN	`JOIN FETCH u.department`

마치며: JPQL 핵심 정리

JPQL 30가지 예제를 통해 기본 SELECT부터 서브쿼리, FETCH JOIN까지 실무에서 자주 쓰이는 패턴을 모두 살펴봤습니다. 중요한 포인트를 다시 정리하면 아래와 같습니다.

엔티티 중심: 테이블이 아닌 엔티티 클래스명과 필드명을 사용합니다.
N+1 해결: 연관 엔티티가 필요하면 반드시 JOIN FETCH를 사용하세요.
DTO 조회: SELECT NEW 구문으로 불필요한 데이터 로딩을 줄이세요.
페이징: LIMIT 대신 Pageable을 파라미터로 넘겨 처리하세요.
네이티브 쿼리: DB 전용 기능이 필요할 때만 nativeQuery = true를 사용하세요.

이 글이 도움이 되셨다면 즐겨찾기 해두고, Spring JPA를 사용할 때 레퍼런스로 활용해 보세요!

Spring Data JPA 쿼리 작성 완벽 가이드 | Query Methods, JPQL, QueryDSL, Native SQL 총정리

zippy — Sun, 19 Apr 2026 01:06:48 +0900

JPA 쿼리는 데이터베이스에서 데이터를 조회·저장·수정·삭제하기 위해 사용하는 명령어를, 객체(Entity)를 기준으로 다루도록 도와주는 도구입니다. SQL처럼 보이지만 테이블이 아닌 엔티티(User)를 사용한다는 점이 핵심입니다. 이 글에서는 Query Methods부터 Native SQL까지 5가지 쿼리 작성 방법을 실습 예제와 함께 완벽하게 정리합니다.

1. JPA 쿼리란 무엇인가? (기초 개념)

핵심 개념

JPA 쿼리는 데이터베이스에서 데이터를 조회·저장·수정·삭제하기 위해 사용하는 명령어를, 객체(Entity)를 기준으로 다루도록 도와주는 도구입니다. SQL처럼 보이지만, 테이블이 아니라 엔티티(User)를 사용합니다.

쉬운 비유 설명

SQL: user라는 테이블 이름을 직접 호출해서 일하는 느낌
JPA 쿼리: User라는 자바 객체(엔티티)를 부르면서 일하는 느낌

즉, "DB야, user 테이블에서 가져와"가 아니라, "JPA야, User 객체들 중에서 골라줘"라고 말하는 것과 같습니다.

️ 실제 코드 예제 (User 엔티티 기준)

import jakarta.persistence.*;
import java.time.LocalDateTime;

@Entity
public class User {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;

    private String email;

    private LocalDateTime createdDate;

    // getters, setters 생략
}

✅ 언제 사용하나?

데이터베이스에서 User 목록을 조회하거나 저장/수정/삭제가 필요할 때 항상 사용합니다.

❌ 피해야 할 경우

JPA를 전혀 쓰지 않는 프로젝트(MyBatis만 사용 등)에서는 사용하지 않습니다.
DB 특수 기능(예: 특정 DB만 지원하는 함수)만 써야 할 때는 Native SQL이 더 적합할 수 있습니다.

2. 5가지 쿼리 방법 개요 및 언제 사용하나?

Spring Data JPA에서 쿼리를 작성하는 대표적인 5가지 방법이 있습니다. 각 방법은 난이도와 쓰임새가 다릅니다.

Query Methods: 메서드 이름 기반 쿼리
JPQL: Java Persistence Query Language
Criteria API: 코드로 쿼리를 조립하는 방식
QueryDSL: 타입 안전한 DSL 기반 쿼리
Native SQL: 순수 SQL 직접 작성

쉬운 비유 설명

Query Methods: "치킨 주문"할 때 메뉴판 번호만 말하는 것 → "1번 세트 주세요"처럼 간단한 주문
JPQL: 직접 레시피를 글로 쓰는 것 → "닭에 양념 바르고 180도에 20분 구워줘" 같은 문장 쿼리
Criteria API: 레고 블록으로 요리를 만드는 느낌 → 코드로 쿼리를 조합
QueryDSL: Criteria보다 똑똑한 레고 세트 → 타입 안전 + 자동완성 지원
Native SQL: 아예 주방에 들어가서 직접 요리를 하는 것 → 순수 SQL 작성

✅ 언제 사용하나? (요약)

Query Methods: 간단한 조건 검색, CRUD, 빠른 개발
JPQL: 조인, 그룹핑, 집계 등 중간 이상 복잡도 쿼리
Criteria API: 화면 검색 조건에 따라 동적으로 쿼리가 계속 바뀔 때
QueryDSL: 실무에서 복잡한 동적 쿼리를 많이 쓸 때 최강
Native SQL: JPA로 표현하기 어려운 특수한 SQL, 성능 최적화가 필요할 때

❌ 피해야 할 경우 (요약)

간단한 쿼리를 Native SQL로 다 써버리기 → 유지보수 지옥
동적 쿼리가 많은데 JPQL 문자 조합만 쓰기 → 코드 난장판

3. JPQL 완전 정복

핵심 개념

JPQL(Java Persistence Query Language)은 엔티티를 기준으로 작성하는 쿼리 언어입니다. SQL과 문법이 비슷하지만, 테이블 이름이 아니라 엔티티 이름(User)을 사용합니다.

쉬운 비유 설명

SQL: SELECT * FROM user WHERE name = '홍길동'
JPQL: SELECT u FROM User u WHERE u.name = '홍길동'

즉, user 테이블이 아니라 User 엔티티를 대상으로 합니다.

️ 기본 JPQL 문법 예시

// Repository 예시
public interface UserRepository extends JpaRepository<User, Long> {

    // 이름이 정확히 일치하는 사용자 조회
    @Query("SELECT u FROM User u WHERE u.name = :name")
    List<User> findByNameUsingJpql(@Param("name") String name);
}

SELECT u FROM User u: User 엔티티를 u라는 별칭으로 조회
WHERE u.name = :name: u의 name 필드가 파라미터 :name과 같은 데이터

️ 실습 예제 5개

예제 1: 이름으로 부분 검색 (LIKE)

@Query("SELECT u FROM User u WHERE u.name LIKE %:name%")
List<User> findByNameContainingJpql(@Param("name") String name);

예제 2: 날짜 범위 검색 (BETWEEN)

@Query("SELECT u FROM User u " +
       "WHERE u.createdDate BETWEEN :start AND :end")
List<User> findByCreatedDateBetweenJpql(
        @Param("start") LocalDateTime start,
        @Param("end") LocalDateTime end
);

예제 3: 여러 조건 (AND)

@Query("SELECT u FROM User u " +
       "WHERE u.name = :name AND u.email = :email")
Optional<User> findByNameAndEmailJpql(
        @Param("name") String name,
        @Param("email") String email
);

예제 4: 정렬해서 상위 N개 조회

@Query("SELECT u FROM User u ORDER BY u.createdDate DESC")
List<User> findRecentUsersJpql(Pageable pageable);

// 사용 예시
PageRequest.of(0, 10); // 최근 10명

예제 5: 개수 세기 (COUNT)

@Query("SELECT COUNT(u) FROM User u WHERE u.email IS NOT NULL")
Long countUsersHasEmail();

여기까지 이해했다면, SELECT / FROM / WHERE / ORDER BY 구조는 SQL과 거의 같고, 테이블 대신 엔티티, 컬럼 대신 필드명을 쓴다는 것만 기억하면 됩니다.

장점

SQL과 비슷해서 입문 난이도가 낮음
엔티티 기준이라 객체지향 코드와 잘 어울림
여러 DB 벤더(MySQL, PostgreSQL 등)에 이식성이 좋음

단점

문자열로 작성하므로, 오타를 컴파일 타임에 잡기 어려움
동적 쿼리(조건이 늘었다 줄었다)는 코드가 지저분해짐

✅ 언제 사용하나? 어느 정도 복잡한 고정 쿼리(조인, 집계, 그룹핑 등)가 필요할 때 적합합니다.

❌ 피해야 할 경우: 화면에 체크박스/검색 조건이 많아서 조건이 자주 바뀌는 검색 쿼리를 만들 때 (이때는 QueryDSL이 더 좋습니다).

4. Query Methods (메서드 이름 쿼리)

핵심 개념

Query Methods는 메서드 이름만으로 쿼리를 자동 생성하는 기능입니다. findBy + 필드명 + 키워드 형태로 쓰면 Spring Data JPA가 알아서 SQL을 만들어 줍니다.

쉬운 비유 설명

메서드 이름이 곧 주문서입니다. findByName이라고 쓰면, 스프링이 "아~ name으로 찾으라는 거구나"라고 알아듣고 쿼리를 만들어 줍니다.

️ 대표 키워드 예시

논리 연산: And, Or
범위 비교: Between, LessThan, GreaterThanEqual
문자열 검색: Like, Containing, StartsWith, EndsWith
NULL 체크: IsNull, IsNotNull
목록 포함 여부: In, NotIn
정렬: OrderBy필드Asc, OrderBy필드Desc

️ 실습 예제 10개

public interface UserRepository extends JpaRepository<User, Long> {

    // 1. 이름이 정확히 같은 사용자 찾기
    List<User> findByName(String name);

    // 2. 이름에 특정 문자열이 포함된 사용자 (LIKE %keyword%)
    List<User> findByNameContaining(String keyword);

    // 3. 이름이 A 이고 이메일이 B 인 사용자
    Optional<User> findByNameAndEmail(String name, String email);

    // 4. 이름이 A 이거나 이메일이 B 인 사용자
    List<User> findByNameOrEmail(String name, String email);

    // 5. id가 특정 값보다 큰 사용자
    List<User> findByIdGreaterThan(Long id);

    // 6. 생성일이 특정 기간 사이인 사용자
    List<User> findByCreatedDateBetween(LocalDateTime start, LocalDateTime end);

    // 7. 이메일이 없는 사용자 (NULL)
    List<User> findByEmailIsNull();

    // 8. 이름으로 찾되, 생성일 내림차순 정렬
    List<User> findByNameOrderByCreatedDateDesc(String name);

    // 9. 이름으로 찾되, 상위 1명만 조회
    Optional<User> findFirstByNameOrderByCreatedDateDesc(String name);

    // 10. 중복 제거 후 이메일로 찾기 (DISTINCT)
    List<User> findDistinctByEmail(String email);
}

✅ 언제 사용하나?

단순 검색 조건(1~3개 정도)일 때
빠르게 CRUD 기능을 만들고 싶을 때
쿼리 문법이 아직 익숙하지 않은 초보자 단계에서 스타트용으로 아주 좋음

❌ 피해야 할 경우

메서드 이름이 너무 길어질 정도로 조건이 복잡할 때 (예: findByNameAndEmailAndCreatedDateBetweenAndStatus...처럼 이름이 괴물이 될 때)
조인, 서브쿼리, 복잡한 그룹핑이 필요할 때

한계 정리: 복잡한 SQL을 표현하기 어렵고, 조건이 조금만 복잡해져도 메서드 이름이 기괴해집니다. 간단한 것은 Query Methods, 조금만 복잡해지면 JPQL 또는 QueryDSL로 넘어가는 것이 좋습니다.

5. Criteria API

핵심 개념

Criteria API는 코드(자바 문법)로 쿼리를 조립하는 방식입니다. 문자열이 아니라, CriteriaBuilder, CriteriaQuery, Root 등을 사용해 쿼리를 만듭니다.

쉬운 비유 설명

JPQL이 "문장으로 설명"이라면, Criteria API는 "레고 블럭으로 조립"입니다. if 문으로 조건을 추가/삭제하기 쉬워서 동적 쿼리에 적합하지만, 코드가 길고 장황해집니다.

️ 단계별 실습 예제

아래 예제는 이름과 이메일을 조건으로, 필요한 것만 동적으로 붙이는 예시입니다.

import jakarta.persistence.*;
import jakarta.persistence.criteria.*;

@Repository
public class UserCriteriaRepository {

    @PersistenceContext
    private EntityManager em;

    public List<User> search(String name, String email) {
        CriteriaBuilder cb = em.getCriteriaBuilder();
        CriteriaQuery<User> cq = cb.createQuery(User.class);

        Root<User> user = cq.from(User.class);

        List<Predicate> predicates = new ArrayList<>();

        // 이름 조건이 있을 때만 추가
        if (name != null && !name.isBlank()) {
            predicates.add(cb.like(user.get("name"), "%" + name + "%"));
        }

        // 이메일 조건이 있을 때만 추가
        if (email != null && !email.isBlank()) {
            predicates.add(cb.equal(user.get("email"), email));
        }

        // 조건 합치기
        cq.where(predicates.toArray(new Predicate[0]));

        return em.createQuery(cq).getResultList();
    }
}

단계별 설명

CriteriaBuilder cb = em.getCriteriaBuilder();: 빌더 꺼내기
CriteriaQuery<User> cq = cb.createQuery(User.class);: User를 조회하는 쿼리 객체 생성
Root<User> user = cq.from(User.class);: FROM User user와 같은 느낌
Predicate 리스트에 조건을 하나씩 추가
마지막에 cq.where(...)로 조건들을 한 번에 적용

✅ 언제 사용하나?

검색 화면에서 체크박스, 드롭다운 등으로 조건이 유동적으로 변할 때
런타임에 조건이 바뀌는 경우(예: 검색 옵션 여러 개)

❌ 피해야 할 경우

쿼리가 단순한데 Criteria를 쓰면 코드가 너무 길어져서 손해
실무에서는 대부분 Criteria 대신 QueryDSL을 더 선호

장황함 해결법: 메서드 분리로 조건별로 작은 메서드로 쪼개거나, Spring Data JPA의 Specification 인터페이스를 활용해 재사용 가능한 조건을 만들 수 있습니다. 하지만 가장 실무적인 해결책은 QueryDSL로 넘어가는 것입니다.

6. QueryDSL (실무 최강자)

핵심 개념

QueryDSL은 타입 안전한(컴파일 시점에 검증되는) 쿼리 DSL(Domain Specific Language)입니다. 엔티티를 기준으로 QUser 같은 클래스를 자동 생성해서, 메서드 체인(Fluent API)으로 쿼리를 작성합니다.

쉬운 비유 설명

Criteria API가 레고 블럭이라면, QueryDSL은 "자동완성 되는 스마트 레고"입니다. user.name.eq("홍길동")처럼, 필드명을 타이핑할 때 IDE가 자동완성을 도와줍니다.

️ Gradle 설정 예시

dependencies {
    implementation "com.querydsl:querydsl-jpa:5.0.0"
    annotationProcessor "com.querydsl:querydsl-apt:5.0.0:jpa"
}

QueryDSL을 설정하면 User 엔티티 기준으로 다음과 같은 클래스가 자동 생성됩니다.

// 자동 생성 (수동 작성 금지)
public class QUser extends EntityPathBase<User> {
    public static final QUser user = new QUser("user");

    public final StringPath name = createString("name");
    public final StringPath email = createString("email");
    public final DateTimePath<LocalDateTime> createdDate = createDateTime("createdDate", LocalDateTime.class);
}

️ Fluent API 실습 예제

예제 1: 이름으로 검색

import com.querydsl.jpa.impl.JPAQueryFactory;
import static com.example.demo.domain.QUser.user;

@Repository
public class UserQuerydslRepository {

    private final JPAQueryFactory queryFactory;

    public UserQuerydslRepository(JPAQueryFactory queryFactory) {
        this.queryFactory = queryFactory;
    }

    public List<User> findByName(String name) {
        return queryFactory
                .selectFrom(user)
                .where(user.name.eq(name))
                .fetch();
    }
}

예제 2: 동적 검색 (이름, 이메일 옵션)

public List<User> search(String name, String email) {
    BooleanBuilder builder = new BooleanBuilder();

    if (name != null && !name.isBlank()) {
        builder.and(user.name.contains(name));
    }

    if (email != null && !email.isBlank()) {
        builder.and(user.email.eq(email));
    }

    return queryFactory
            .selectFrom(user)
            .where(builder)
            .fetch();
}

예제 3: 정렬 + 페이징

public List<User> findRecentUsers(int page, int size) {
    return queryFactory
            .selectFrom(user)
            .orderBy(user.createdDate.desc())
            .offset((long) page * size)
            .limit(size)
            .fetch();
}

✅ 언제 사용하나?

동적 검색 조건이 많은 페이지(검색 화면, 필터링이 많은 리스트 화면 등)
협업이 많고, 장기 프로젝트에서 가독성 + 유지보수성이 중요한 경우

❌ 피해야 할 경우: 아주 작은 프로젝트나 간단한 CRUD만 필요한 토이 프로젝트(설정 비용이 아까울 수 있음)

Criteria API vs QueryDSL 비교

항목	Criteria API	QueryDSL
코드 길이	매우 김	상대적으로 짧음
타입 안전성	있음	있음
가독성	낮음	높음
IDE 자동완성	제한적	매우 좋음
실무 사용 빈도	낮음	높음

실무에서는 Criteria API 대신 QueryDSL을 사용하는 경우가 훨씬 많습니다.

7. Native SQL

핵심 개념

Native SQL은 JPA가 제공하는 추상화 계층을 넘어서, DB에 직접 SQL을 날리는 방식입니다. @Query(nativeQuery = true)를 사용해 순수 SQL을 그대로 작성합니다.

쉬운 비유 설명

지금까지는 번역가(JPA)가 대신 말해줬다면, Native SQL은 번역가 없이 직접 외국어(DB 언어)를 쓰는 것입니다.

✅ 언제 사용하나?

JPA/JPQL로 표현하기 어려운 복잡한 SQL이 필요할 때
DB 전용 함수, 윈도우 함수, FULL TEXT SEARCH 등 특수 기능을 사용할 때

❌ 피해야 할 경우: 단순 조회/저장까지 전부 Native로 처리하면 JPA의 장점을 거의 버리는 것과 같습니다.

️ @Query 작성법

public interface UserRepository extends JpaRepository<User, Long> {

    // 1. 이름으로 검색 (Native SQL)
    @Query(value = "SELECT * FROM user WHERE name = :name", nativeQuery = true)
    List<User> findByNameNative(@Param("name") String name);

    // 2. 날짜 범위 + 정렬
    @Query(value = "SELECT * FROM user " +
                   "WHERE created_date BETWEEN :start AND :end " +
                   "ORDER BY created_date DESC",
           nativeQuery = true)
    List<User> findByCreatedDateBetweenNative(
            @Param("start") LocalDateTime start,
            @Param("end") LocalDateTime end
    );

    // 3. 개수 세기
    @Query(value = "SELECT COUNT(*) FROM user WHERE email IS NOT NULL", nativeQuery = true)
    Long countUsersHasEmailNative();
}

주의사항

테이블 이름, 컬럼 이름을 직접 써야 하므로, 엔티티 변경 시 SQL도 같이 고쳐야 합니다.
DB 종류를 바꾸면 SQL 문법 차이로 쿼리가 그대로 동작하지 않을 수 있습니다.
프로젝트 전체의 10~20% 정도, 꼭 필요할 때만 제한적으로 사용하는 것이 좋습니다.

8. 5가지 방법 완벽 비교표

방법	난이도	동적쿼리 지원	성능	실무 사용도	특징 요약
Query Methods	매우 쉬움	거의 없음	좋음	매우 높음	메서드 이름만으로 쿼리 자동 생성
JPQL	중간	문자열 조합으로 가능(불편)	좋음	높음	엔티티 기준의 객체지향 쿼리
Criteria API	어려움	좋음	좋음	낮음	동적 쿼리 가능하지만 코드 장황
QueryDSL	중간~조금 어려움	매우 좋음	좋음~최상	매우 높음	실무 동적 쿼리의 사실상 표준
Native SQL	중간	SQL로 직접 처리	최상 (튜닝 여지 큼)	중간	특수 기능/최적화용 보조 수단

9. 실무 선택 가이드

핵심 개념

실무에서는 보통 하나만 쓰지 않고, 여러 가지를 섞어서 사용합니다. 하지만 기본 축은 Query Methods + JPQL + QueryDSL 조합인 경우가 많습니다.

추천 조합 (단계별)

기본 CRUD, 단순 조회: Query Methods
고정된 복잡 쿼리: JPQL (@Query)
동적 검색, 조건이 많은 화면: QueryDSL
성능 최적화/특수 기능: Native SQL (필요할 때만)

️ 예시 시나리오: 회원 관리 페이지

findByEmail → Query Method
회원 + 주문 + 결제 상태 복잡 조인 → JPQL 또는 QueryDSL
검색 필터(이름, 기간, 상태, 등급 등) → QueryDSL

✅ 실무에서의 좋은 전략 (새 프로젝트 시작 시)

무조건 Query Methods 먼저로 간단히 기능 구현
복잡해지는 지점부터 JPQL 또는 QueryDSL로 분리
성능이 중요한 핵심 쿼리는 필요 시 Native SQL 도입

❌ 피해야 할 선택

처음부터 모든 쿼리를 Native SQL로 작성
단순 CRUD까지 QueryDSL로만 하겠다며 과도하게 복잡하게 설계

10. 흔한 실수와 해결법

실수 1: N+1 문제를 무시

연관관계가 있는 엔티티를 조회할 때 쿼리가 여러 번 나가는 문제입니다. 해결: fetch join, @EntityGraph 등을 사용해 한 번에 함께 로딩합니다.

실수 2: Query Methods에 모든 걸 우겨 넣기

메서드 이름이 너무 길어져서 가독성이 떨어집니다. 해결: 일정 수준 이상 복잡해지면 JPQL/QueryDSL로 과감히 분리합니다.

실수 3: Native SQL에서 엔티티 변경을 반영 안 함

컬럼명/테이블명 변경 시 Native 쿼리가 깨집니다. 해결: Native SQL은 최소화하고, 사용 시 반드시 테스트 코드로 커버합니다.

실수 4: 쿼리 디버깅을 안 켜놓음

실제로 DB에 어떤 SQL이 나가는지 모르는 상태로 개발하게 됩니다. 해결: 개발 환경에서 다음 설정으로 SQL을 항상 눈으로 확인합니다.

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

11. 다음 스텝 학습 로드맵

JPA 쿼리는 한 번에 다 이해하기 어렵습니다. 단계별로 조금씩 올라가는 것이 좋습니다.

추천 학습 순서 (왕초보 기준)

1단계: Query Methods 완전 정복

User 엔티티로 findByName, findByEmail, findByCreatedDateBetween 등 10개 이상 직접 만들어보기

2단계: JPQL 맛보기

@Query로 간단한 SELECT, WHERE, ORDER BY, COUNT 등을 직접 작성하고, SQL과 JPQL의 차이(테이블 vs 엔티티)를 몸으로 익히기

3단계: QueryDSL 도입

QUser 클래스가 어떻게 생성되는지 확인하고, selectFrom(user).where(...).fetch() 패턴에 익숙해지기. 동적 검색 화면 하나를 QueryDSL로 구현해보기

4단계: 성능 및 고급 주제

N+1 문제, 페이징, 캐시, fetch join, batch size 등

5단계: Native SQL 적절히 활용

정말 JPA로 표현하기 어려운 쿼리만 Native로 작성하고, 항상 테스트 코드로 검증

마지막 체크리스트 ("이해했어요!" 자기 점검)

User 엔티티 기준으로 Query Methods 10개 이상 직접 만들 수 있다.
JPQL로 SELECT / WHERE / ORDER BY / COUNT를 직접 작성해 볼 수 있다.
Criteria API가 왜 장황한지, 언제 쓰면 좋은지 설명할 수 있다.
QueryDSL 코드(selectFrom(user).where(...))를 보고 대략 어떤 쿼리인지 이해할 수 있다.
Native SQL이 언제 필요한지, 왜 전부 Native로 쓰면 안 되는지 말할 수 있다.

위 체크리스트에 모두 체크할 수 있다면, 이제 "이해했어요!"라고 말해도 충분한 수준입니다. 직접 작은 Spring Boot 프로젝트를 만들어, 이 가이드에 나온 예제들을 하나씩 따라 치면서 몸에 익혀보세요.

Spring Boot 소스코드 분석 방법 총정리 | GitHub 저장소 구조, AutoConfiguration, 학습 로드맵

zippy — Sun, 19 Apr 2026 01:04:17 +0900

Spring Boot의 GitHub 저장소는 단순한 소스코드 모음이 아닙니다. 자동 구성의 원리, 최고 수준의 코딩 패턴, 실무 문제 해결 방식까지 모두 담긴 살아있는 교과서입니다. 이 가이드는 저장소를 처음 탐색하는 분부터 커뮤니티 기여를 준비하는 분까지, 단계별로 활용하는 방법을 상세히 안내합니다.

1. 저장소 기본 정보

Spring Boot 저장소를 활용하기 전에 핵심 링크와 브랜치 전략을 먼저 파악해두면 학습 효율이 크게 올라갑니다.

핵심 링크

메인 저장소: https://github.com/spring-projects/spring-boot
이슈 트래커: https://github.com/spring-projects/spring-boot/issues
위키: https://github.com/spring-projects/spring-boot/wiki
토론: https://github.com/spring-projects/spring-boot/discussions
공식 문서: https://docs.spring.io/spring-boot/

브랜치 전략

main: 최신 개발 버전 (보통 다음 마이너/메이저 버전)
유지보수 브랜치: {major}.{minor}.x 형식 (예: 3.2.x, 4.0.x)
브랜치 선택 팁: 안정성이 중요하면 3.2.x, 최신 기능을 보고 싶다면 main

2. 저장소 구조 이해

저장소의 전체 구조를 먼저 파악하면 원하는 코드를 빠르게 찾을 수 있습니다.

전체 디렉토리 구조

spring-boot/
├── spring-boot-project/                    # 메인 프로젝트
│   ├── spring-boot/                        # 핵심 부트스트랩 로직
│   │   ├── src/main/java                   # 메인 소스 (SpringApplication, ...)
│   │   ├── src/test/java                   # 핵심 기능 테스트
│   │   └── pom.xml                         # 핵심 모듈 의존성
│   │
│   ├── spring-boot-autoconfigure/          # 자동 구성의 핵심
│   │   ├── src/main/java/.../autoconfigure/  # 각 기술별 AutoConfiguration
│   │   ├── META-INF/spring/                  # 자동 구성 진입점
│   │   └── src/test/java/.../autoconfigure/  # AutoConfiguration 테스트
│   │
│   ├── spring-boot-starters/               # 스타터 의존성 정의
│   │   ├── spring-boot-starter/            # 기본 스타터
│   │   ├── spring-boot-starter-web/        # Web 기반 스타터
│   │   ├── spring-boot-starter-data-jpa/   # JPA 스타터
│   │   ├── spring-boot-starter-security/   # Security 스타터
│   │   └── ...
│   │
│   ├── spring-boot-test/                   # 테스트 지원 라이브러리
│   │   ├── @SpringBootTest 구현
│   │   ├── TestRestTemplate
│   │   └── 테스트 유틸리티
│   │
│   ├── spring-boot-tools/                  # 빌드 도구
│   │   ├── spring-boot-maven-plugin/       # Maven 플러그인
│   │   └── spring-boot-gradle-plugin/      # Gradle 플러그인
│   │
│   └── spring-boot-dependencies/           # 의존성 버전 관리 (BOM)
│
├── spring-boot-tests/                      # 통합 테스트 모음
│   ├── smoke-tests/                        # 기본 기능 검증
│   └── integration-tests/
│
├── docs/                                   # 공식 문서 (Asciidoctor)
│   ├── src/main/asciidoc
│   ├── spring-boot-reference/
│   └── spring-boot-maven-plugin/
│
└── README.md                               # 저장소 개요

핵심 모듈별 역할

모듈	파일 위치	주요 학습 포인트
spring-boot	spring-boot-project/spring-boot	ApplicationContext, 라이프사이클, SpringApplication
spring-boot-autoconfigure	spring-boot-project/spring-boot-autoconfigure	@AutoConfiguration, @Conditional, 조건부 로직
spring-boot-starters	spring-boot-project/spring-boot-starters	POM 구성, 의존성 조합, 버전 관리
spring-boot-test	spring-boot-project/spring-boot-test	@SpringBootTest, TestRestTemplate, 테스트 패턴
spring-boot-dependencies	spring-boot-project/spring-boot-dependencies	버전 관리, 의존성 호환성

3. 효과적인 학습 전략

무작정 코드를 읽기보다는 아래의 단계별 전략을 따라가면 훨씬 빠르게 핵심을 체득할 수 있습니다.

Phase 1: 기초 개념 이해 (2-3주)

1단계: 자동 구성의 진입점 파악

GitHub 탐색:
1. spring-boot-project/spring-boot-autoconfigure 폴더 열기
2. src/main/resources/META-INF/spring/ 확인
3. org.springframework.boot.autoconfigure.AutoConfiguration.imports 파일 열기

학습 포인트:
- 이 파일이 모든 AutoConfiguration의 진입점
- 약 100여 개의 AutoConfiguration 클래스 나열됨
- 실행 순서가 중요함

2단계: 간단한 AutoConfiguration 3개 분석

추천 순서 (쉬운 것부터):
1. JdbcAutoConfiguration
2. DataSourceAutoConfiguration
3. JpaRepositoriesAutoConfiguration

각각에 대해:
□ 클래스 선언부 (@AutoConfiguration, @Conditional...)
□ Bean 생성 메서드 검토
□ 테스트 코드 확인
□ 의존성 순서 이해

3단계: 스타터 의존성 구조 이해

GitHub 탐색:
1. spring-boot-starters 폴더 열기
2. spring-boot-starter 열기 → pom.xml (기본 의존성)
3. spring-boot-starter-web 열기 → pom.xml (웹 의존성)

학습 포인트:
- 각 스타터가 어떤 라이브러리 조합을 제공하는가?
- optional이 true인 의존성은 왜인가?
- parent는 어디서 관리되는가?

Phase 2: 실전 코드 분석 (3-4주)

4단계: 선택한 주제 심화 학습

예시: Spring Data JPA를 깊이 있게 이해하고 싶다면 아래 순서로 진행합니다.

1. spring-boot-starter-data-jpa 분석
   - 포함된 의존성 확인
   - 버전 관리 방식

2. JpaRepositoriesAutoConfiguration 분석
   - 어떤 조건에서 활성화되는가?
   - 생성되는 주요 Bean은?
   - 테스트 코드로 검증

3. 테스트 코드 읽기
   - spring-boot-autoconfigure/src/test/java/.../JpaRepositoriesAutoConfigurationTests.java
   - 자동 구성이 어떻게 작동하는지 실제로 확인

4. 이슈/PR 트래킹
   - "data-jpa" 검색
   - 최근 개선사항 이해

5단계: 자신의 프로젝트와 연결

학습한 AutoConfiguration을 자신의 프로젝트에 적용:

1. 사용 중인 각 스타터 분석
2. 자동 구성되는 Bean 확인 (IDE debugger 사용)
3. 오버라이드 또는 커스터마이징 가능 여부 검토
4. 필요시 문서화

Phase 3: 커뮤니티 참여 (지속적)

충분한 코드 이해가 쌓이면 이슈 토론 참여, 문서 개선, PR 제출 등으로 커뮤니티에 기여할 수 있습니다. 이 단계는 아래 "커뮤니티 참여 가이드" 섹션에서 자세히 다룹니다.

4. GitHub 기능별 활용 방법

GitHub의 각 기능을 전략적으로 활용하면 코드 탐색 이상의 깊은 학습이 가능합니다.

Issues (이슈) 활용법

이슈 탭은 버그 신고와 기능 요청이 모두 담긴 공간입니다. 아래 필터를 조합해 효과적으로 탐색하세요.

효과적인 필터 조합:

1. "good-first-issue" 라벨
   → 처음 기여자를 위한 이슈
   → 읽고 이해하기 쉬움

2. "help-wanted" 라벨
   → 커뮤니티 도움 필요
   → 해결 시 의미 있는 기여

3. 특정 버전 라벨 (예: "4.0.0")
   → 버전별 주요 변경사항
   → 업그레이드 영향도 파악

4. 특정 기능 (예: "auto-configuration", "data-jpa")
   → 관심사 영역 집중 학습

5. 상태별 필터
   - Closed: 해결된 문제 (학습 용도로 적합)
   - Open: 진행 중인 논의

각 이슈를 읽을 때는 제목과 설명(문제 파악) → 코멘트(분석 과정) → 연결된 PR(해결 방법) → PR 코드 검토 순으로 따라가면 실무적 문제 해결 사고방식을 자연스럽게 익힐 수 있습니다.

Wiki 활용법

Team Practices: https://github.com/spring-projects/spring-boot/wiki/Team-Practices 에서 코드 스타일, Javadoc 작성 방식, 커밋 메시지 형식 등을 확인하고 자신의 프로젝트에 동일한 규칙을 적용해보세요.
Release Notes: 각 주요 버전마다 릴리스 노트가 제공됩니다. 주요 기능 추가, Breaking changes, 마이그레이션 가이드, 성능 개선 내용이 담겨 있어 버전 업그레이드 시 영향 범위를 사전에 파악하는 데 매우 유용합니다.

Pull Requests (PR) 활용법

주요 PR 분석 절차:
1. GitHub의 "Pull requests" 탭 클릭
2. 특정 라벨(예: "auto-configuration")로 필터
3. 머지된 PR 확인 (Merged 상태)

각 PR에서:
□ 제목과 설명 읽기
□ "Files changed" 탭에서 코드 변경 검토
□ "Conversation" 탭에서 리뷰 의견 확인
□ 테스트 코드 추가 여부 확인

버전 간 주요 변경사항을 파악하려면 main 브랜치의 PR을 "4.0.0" 라벨로 필터링하고 "breaking change" 태그를 확인하세요. 이를 통해 자신의 프로젝트 업그레이드 계획을 세울 수 있습니다.

Discussions 활용법

Discussions 탭은 이슈와 달리 버그 보고가 아닌 질문과 논의를 위한 공간입니다. 커뮤니티가 실제로 어떤 문제를 겪고 있는지, 새 기능 제안과 그 이유, 그리고 Best practices 공유가 활발하게 이루어집니다. 자신의 프로젝트에서 경험한 문제와 유사한 케이스를 검색하고, 필요시 자신의 경험을 공유해보세요.

5. 실전 분석 기법

IDE와 Git을 적극 활용하면 코드 탐색의 깊이가 완전히 달라집니다.

IntelliJ IDEA 필수 단축키

기능	Windows/Linux	Mac
심볼 검색	Ctrl+Shift+O	Cmd+Shift+O
파일 검색	Ctrl+Shift+N	Cmd+Shift+N
상속 계층 구조	Ctrl+H	Cmd+H
클래스 사용처 찾기	Ctrl+F7	Cmd+F7
메서드 호출 트리	F4	F4

권장 분석 절차

# 1. 저장소 클론
git clone https://github.com/spring-projects/spring-boot.git

# 2. IDE에서 열기
File → Open → spring-boot 폴더

# 3. 특정 클래스 분석 예시: @SpringBootApplication 검색

# 4. 계층 탐색
- SpringBootApplication 정의 확인
- EnableAutoConfiguration 추적
- AutoConfigurationImportSelector 분석

# 5. 관련 테스트 코드 검토
src/test/java에서 테스트 확인

테스트 코드를 통한 학습

테스트 코드는 자동 구성의 가장 정확한 사용 설명서입니다. 아래 패턴으로 테스트 파일을 찾으세요.

패턴:
src/test/java/org/springframework/boot/autoconfigure/{feature}/
  → {Feature}AutoConfigurationTests.java

예시:
- JdbcTemplateAutoConfigurationTests.java
- DataSourceAutoConfigurationTests.java
- JpaRepositoriesAutoConfigurationTests.java

각 테스트 클래스마다 @SpringBootTest 설정, whenX_thenY 패턴의 메서드 이름, 자동 구성 활성화 조건, 사용자 정의 Bean 오버라이드 케이스, 실패 케이스(어떤 조건에서 Bean이 생성되지 않는지)를 체크리스트로 삼아 분석하세요.

Git 히스토리를 통한 진화 과정 파악

# 파일의 모든 커밋 보기
git log --oneline spring-boot-autoconfigure/src/main/java/.../{Feature}AutoConfiguration.java

# 상세 변경 이력
git log -p spring-boot-autoconfigure/src/main/java/.../{Feature}AutoConfiguration.java | head -200

# 특정 시간대의 변경
git log --since="2023-01-01" --until="2023-12-31" --oneline

GitHub 웹에서는 파일을 열고 오른쪽의 "Blame" 버튼을 클릭하면 각 라인의 작성자, 커밋, 메시지를 한눈에 확인할 수 있습니다. 커밋을 클릭하면 당시의 전체 변경사항도 볼 수 있어, "왜 이렇게 구현했는가"에 대한 맥락을 파악하는 데 매우 효과적입니다.

6. 자동 구성 심화 학습

AutoConfiguration은 Spring Boot의 핵심입니다. 체계적인 분석 체크리스트와 학습 순서를 따라가세요.

AutoConfiguration 분석 체크리스트

1. 클래스 선언부 분석
   □ @AutoConfiguration 존재?
   □ after = ... 이 있는가? (의존성)
   □ before = ... 이 있는가?

2. 클래스 레벨 @Conditional 확인
   □ @ConditionalOnClass: 어떤 클래스 필요?
   □ @ConditionalOnProperty: 어떤 프로퍼티?
   □ @ConditionalOnWebApplication: 웹 앱만?

3. Bean 생성 메서드 검토
   □ @Bean 메서드 몇 개?
   □ 각 Bean의 @ConditionalOnMissingBean은?
   □ 메서드 파라미터 (의존성)는?

4. 관련 @Configuration 중첩 클래스
   □ 조건부 내부 구성?
   □ 특정 환경에서만 활성화?

5. 테스트 코드 확인
   □ 테스트가 몇 개?
   □ 정상 케이스만? 실패 케이스도?
   □ 사용자 정의 Bean 오버라이드 테스트?

주요 AutoConfiguration 학습 순서

초급 (이해하기 쉬운 것부터)

NoOpAutoConfiguration: 가장 단순한 예제로 자동 구성의 기본 구조를 파악합니다.
JdbcAutoConfiguration: JDBC Template 자동 구성으로 데이터 소스 의존성과 비교적 단순한 로직을 학습합니다.
TransactionAutoConfiguration: 트랜잭션 관리자 자동 구성과 Platform Transaction Manager를 이해합니다.

중급 (이해 난도 있음)

DataSourceAutoConfiguration: 여러 데이터 소스 지원과 복잡한 조건부 로직, 환경별 설정을 다룹니다.
WebMvcAutoConfiguration: 웹 요청 처리, ViewResolver, MessageConverter, DispatcherServlet 설정을 학습합니다.
JpaRepositoriesAutoConfiguration: Spring Data 통합과 다양한 Conditional 로직을 이해합니다.

상급 (복잡한 구조)

SecurityAutoConfiguration: 보안 설정과 여러 내부 Configuration 클래스, 사용자 정의 보안 오버라이드를 다룹니다.
CacheAutoConfiguration: 다양한 캐싱 구현 지원, CacheManager 자동 선택, 복잡한 조건부 로직을 학습합니다.

7. 커뮤니티 참여 가이드

오픈소스 기여는 거창하게 시작할 필요 없습니다. 문서 오타 수정이나 테스트 추가부터 시작하면 됩니다.

첫 번째 기여 준비

저장소의 CONTRIBUTING.md 파일을 반드시 먼저 읽으세요. CLA(Contributor License Agreement) 동의 필수, 코딩 스타일 가이드, 테스트 작성 규칙, 커밋 메시지 형식, PR 작성 방법이 모두 담겨 있습니다.

로컬 개발 환경 설정

# Fork 저장소 후 Clone
git clone https://github.com/YOUR-USERNAME/spring-boot.git
cd spring-boot

# 개발 브랜치 생성
git checkout -b feature/issue-XXXXX

# 빌드 및 테스트
./mvnw clean install -DskipTests

# 특정 모듈만 테스트
./mvnw -pl spring-boot-project/spring-boot-autoconfigure test

기여 가능 영역별 난이도

영역	난이도	입문자 추천
버그 수정	중간	○
문서 개선	낮음	◎ (강력 권장)
테스트 추가	낮음	◎ (강력 권장)
새 기능	높음	×
성능 최적화	높음	×

효과적인 PR 작성 템플릿

## 설명
이 PR의 목적은 #XXXXX를 해결하기 위함입니다.

## 변경 사항
- 주요 변경 1
- 주요 변경 2

## 테스트
- [ ] 기존 테스트 모두 통과
- [ ] 새 테스트 추가
- [ ] 로컬에서 검증

## 체크리스트
- [ ] 코드 스타일 준수
- [ ] Javadoc 추가
- [ ] 관련 문서 업데이트

8. 학습 로드맵

꾸준한 루틴이 실력 성장의 핵심입니다. 월별 계획과 주간 루틴을 참고해 자신의 페이스에 맞게 조정하세요.

월별 학습 계획

1개월 차: 기초 다지기

주 1: 전체 디렉토리 구조 파악, 각 주요 모듈 역할 이해, 브랜치 전략 학습
주 2-3: 간단한 AutoConfiguration 5개 분석, 각 테스트 코드 검토, 자신의 프로젝트와 비교
주 4: 스타터 3개 분석, 의존성 관계도 작성, 자신의 pom.xml과 비교

2-3개월 차: 심화 학습

주 5-8: 선택한 주제의 모든 AutoConfiguration 분석, 테스트 코드 상세 검토, 이슈/PR 트래킹 시작, 자신의 프로젝트에 적용
주 9-12: 커스텀 AutoConfiguration 작성, 단위 테스트 작성, 팀원과 코드 리뷰, 문서화

4-6개월 차: 커뮤니티 참여

달 4-5: 기여 방법 완전 숙지, 간단한 이슈 또는 문서 개선, PR 작성 및 피드백 받기
달 6 이상: 관심 영역 주기적 모니터링, 코드 리뷰 참여, 커뮤니티 질문에 답변

주간 학습 루틴 (권장)

월요일 (20분): 새로운 "good-first-issue" 확인, 주간 학습 대상 선정
화, 수요일 (각 1시간): AutoConfiguration 클래스 2-3개 분석, 관련 테스트 코드 검토, 문제점 노트 정리
목요일 (1시간): 특정 이슈의 논의 과정 읽기, PR의 코드 변경사항 분석, 리뷰 의견과 수정 과정 이해
금요일 (30분): 주간 학습 내용 정리, 자신의 프로젝트에 적용 가능성 검토, 다음 주 계획 수립

실전 팁과 주의사항

학습 효율을 높이는 팁과 흔히 하는 실수를 함께 정리했습니다.

효과적인 학습을 위한 팁

한 번에 한 가지에 집중: 전체 코드를 한꺼번에 읽으려 하지 말고, 한 모듈/클래스만 깊이 있게 파고드세요.
테스트 코드부터 읽기: 테스트는 코드의 사용 설명서입니다. 정상 케이스와 실패 케이스가 모두 담겨 있습니다.
IDE의 디버거 적극 활용: 실제 실행 흐름을 추적하고 변수값 변화를 직접 확인하세요.
자신의 프로젝트에 즉시 적용: 이론이 실전 경험으로 변환되고, 문제점 발견 시 더 깊은 학습이 이어집니다.
정기적으로 회고: 매달 배운 내용을 정리하고 적용한 사항을 검토하세요.

자주 하는 실수와 해결책

실수	문제점	해결책
최신 main 브랜치만 보기	기능 충돌, 혼동 발생	안정 버전(3.2.x) 먼저 학습
문서 없이 코드만 읽기	왜인지 이해 못함	테스트 코드부터 시작
전체 구조 이해하려 함	압도감, 포기	한 모듈만 집중
혼자만 학습	피드백 부족, 진행 정체	커뮤니티와 함께
배운 것 적용 안 함	개념 이해만, 실전 응용 못함	학습하며 즉시 적용

추가 리소스

공식 문서

Spring Boot 공식 문서: https://docs.spring.io/spring-boot/
Spring Framework: https://spring.io/projects/spring-framework
Spring Data: https://spring.io/projects/spring-data

커뮤니티

Stack Overflow: spring-boot 태그
GitHub Discussions: spring-boot 저장소의 Discussions 탭
Gitter Channel: spring-projects/spring-boot

추천 학습 자료

Spring Boot 공식 가이드: Getting Started Guides
Baeldung Spring Boot 튜토리얼: https://www.baeldung.com
토비의 스프링 부트: 아키텍처 깊이 있는 이해에 추천

마치며

Spring Boot GitHub 저장소는 단순히 소스코드 모음이 아니라, 스프링 부트의 아키텍처와 철학을 배우는 최고의 교과서입니다. 체계적인 학습을 통해 다음을 얻을 수 있습니다.

자동 구성의 작동 원리 이해
최고 수준의 코딩 패턴과 스타일 학습
실무에서 발생하는 문제들의 해결 방법 습득
점진적으로 Spring Boot 커뮤니티의 일원이 되는 경험

차근차근 진행하고, 자신의 페이스를 유지하며, 학습한 내용을 실제 프로젝트에 적용하다 보면 Spring Boot에 대한 이해가 한 단계 깊어질 것입니다. Happy Learning!

Spring Boot GitHub 저장소 완벽 가이드: 초보자도 5단계로 끝내는 코드 읽기

zippy — Sun, 19 Apr 2026 01:02:17 +0900

Spring Boot를 처음 배우기 시작했지만 GitHub 저장소가 어떻게 생겼는지, 어디서 무엇을 찾아야 할지 막막한가요? 이 가이드 하나로 Spring Boot 저장소에서 필요한 정보를 찾아 이해하고 활용할 수 있게 됩니다.

이 가이드가 필요한 당신

Spring Boot를 처음 배우는 중이다
GitHub 저장소가 어떻게 생겼는지 모른다
어디서 어떤 정보를 찾아야 할지 모른다
저장소의 코드가 무엇을 의미하는지 모른다
배운 걸 자신의 프로젝트에 적용하고 싶다

이 가이드를 읽으면: "Spring Boot 저장소에서 필요한 정보를 찾아 이해하고 활용할 수 있다"

5단계로 배우는 Spring Boot GitHub 저장소

Step 1: "이게 뭐지?" - 저장소 방문하기 (5분)

저장소 주소: https://github.com/spring-projects/spring-boot

저장소에 처음 접속하면 아래와 같은 화면이 보입니다.

┌─────────────────────────────────────────┐
│ Code (여기에 있음) | Issues | Pull requests│
├─────────────────────────────────────────┤
│ main ▼          [검색창]                  │
├─────────────────────────────────────────┤
│   spring-boot-project/    (폴더)        │
│   spring-boot-tests/      (폴더)        │
│   docs/                   (폴더)        │
│   README.md               (파일)        │
│   pom.xml                 (파일)        │
└─────────────────────────────────────────┘

복잡해 보이지만 걱정하지 마세요. 여기서 볼 핵심 폴더는 3개뿐입니다!

Step 2: "폴더들의 정체" - 구조 이해하기 (10분)

1️⃣ spring-boot-autoconfigure (⭐ 초보자 추천!)

목적: "Spring Boot가 뭘 자동으로 설정하는가" 배우는 곳

spring-boot-autoconfigure/
├─ src/main/java/...
│  ├─ jdbc/
│  │  └─ JdbcAutoConfiguration.java    (DB 자동 설정)
│  ├─ data/jpa/
│  │  └─ JpaAutoConfiguration.java     (JPA 자동 설정)
│  ├─ web/
│  │  └─ WebMvcAutoConfiguration.java  (웹 자동 설정)
│  └─ security/
│     └─ SecurityAutoConfiguration.java (보안 자동 설정)
│
└─ src/test/java/...
   └─ (위와 같은 구조인데 Tests.java로 끝남)

언제 들어가나? "JPA 자동 설정이 뭔지?" 궁금할 때
파일 이름 패턴: 기술이름 + AutoConfiguration / 기술이름 + AutoConfigurationTests

2️⃣ spring-boot-starters

목적: "각 스타터에 뭐가 들어있는가" 알 수 있는 곳

spring-boot-starters/
├─ spring-boot-starter/          (기본)
├─ spring-boot-starter-web/      (웹 개발)
├─ spring-boot-starter-data-jpa/ (데이터베이스)
├─ spring-boot-starter-security/ (보안)
└─ ... (더 많은 스타터들)

각 폴더 안에는:
├─ pom.xml (그 스타터의 의존성 정의)
└─ (그것뿐!)

언제 들어가나? "spring-boot-starter-web에 뭐가 들어있나?" 궁금할 때

3️⃣ spring-boot

목적: "Spring Boot가 어떻게 시작되는가" 배우는 곳

spring-boot/
├─ src/main/java/
│  └─ org/springframework/boot/...
│     ├─ SpringApplication.java      (시작 클래스)
│     ├─ ApplicationContext.java      (Bean 관리)
│     └─ ... (핵심 클래스들)
│
└─ src/test/java/
   └─ ... (테스트 코드들)

언제 들어가나? "Spring Boot가 어떻게 작동하나?" 깊이 있게 알고 싶을 때 (초보자는 나중에 봐도 됩니다)

기타 폴더들

spring-boot-tests/: 통합 테스트 (지금은 Skip 가능)
docs/: 공식 문서 (초보자에게 다소 어려울 수 있음)

Step 3: "어떻게 찾지?" - 파일 찾는 법 (5분)

방법 1: GitHub 검색 (가장 쉬움!)

저장소 페이지에서 / 키 누르기 또는 "Go to file" 버튼 클릭
찾는 파일 이름 입력 (예: JdbcAutoConfiguration)
엔터 누르기
파일 클릭해서 열기

방법 2: 폴더 따라가기

예: "JPA 자동 설정을 찾고 싶다"

spring-boot-project 클릭
spring-boot-autoconfigure 클릭
src → main → java 클릭
org/springframework/boot/autoconfigure 따라가기
data → jpa 클릭
JpaAutoConfiguration.java 클릭

팁: 폴더가 많으면 "Go to file" (방법 1)이 훨씬 빠릅니다!

Step 4: "파일을 열었는데 뭐지?" - 파일 읽는 법 (15분)

자동 설정 파일 (AutoConfiguration.java) 읽는 법

파일 이름: JdbcAutoConfiguration.java

//   최상단: 파일 설명 (중요!)
/**
 * Auto-configuration for JDBC access to a database.
 *
 * → "이 파일은 JDBC로 데이터베이스에 접근하는 걸 자동 설정한다"
 */

//   클래스 선언 (3가지 찾아보기)
@AutoConfiguration(after = DataSourceAutoConfiguration.class)
// → 1. "순서" : 데이터소스 설정 다음에 실행한다는 뜻

@ConditionalOnClass(JdbcTemplate.class)
// → 2. "조건" : JdbcTemplate이라는 클래스가 있을 때만 실행

public class JdbcAutoConfiguration {

    //   Bean 생성 메서드 (가장 중요!)
    @Bean
    @ConditionalOnMissingBean(JdbcTemplate.class)
    public JdbcTemplate jdbcTemplate(DataSource dataSource) {
        return new JdbcTemplate(dataSource);
    }
    // → 3. "생성" : JdbcTemplate이라는 Bean을 만든다는 뜻
    //             (단, 사용자가 이미 만들었으면 만들지 않음)
}

읽을 때 꼭 답해야 할 3가지:

이 설정은 언제 실행되나? → @Conditional* 라인 읽기 → "JdbcTemplate 클래스가 있으면 실행"
뭘 만드는가? → @Bean 메서드 찾기 → "JdbcTemplate이라는 Bean을 만든다"
사용자가 오버라이드할 수 있나? → @ConditionalOnMissingBean 있는지 확인 → "사용자가 이미 만들었으면 만들지 않는다" (YES)

테스트 파일 (*Tests.java) 읽는 법

테스트 파일을 꼭 읽어야 하는 이유가 있습니다.

코드만 읽으면 → "이게 뭐 하는 건지" 이해 못함
테스트도 읽으면 → "이렇게 작동한다는 증거"를 본다

즉, 테스트 파일은 "사용 설명서" + "증거"입니다.

// 파일 이름: JdbcAutoConfigurationTests.java

@SpringBootTest
// → "진짜로 Spring Boot를 실행해서 테스트한다"는 뜻
class JdbcAutoConfigurationTests {

    //   테스트 1: 정상 케이스
    @Test
    void testJdbcTemplateBacksOff() {
        // "JdbcTemplate이 자동으로 생성된다"는 것을 증명
    }

    //   테스트 2: 사용자 설정 케이스
    @Test
    void testJdbcTemplateWhenUserProvided() {
        // "사용자가 직접 만들면 그것을 쓴다"는 것을 증명
    }
}

테스트를 읽을 때:

메서드 이름 읽기 (가장 중요!): testJdbcTemplateBacksOff → "JdbcTemplate이 자동으로 생성된다"
@Test가 뭔가? → "이것이 테스트한다"는 뜻 (코드의 증명)
메서드 안의 코드는 이해 안 해도 된다 → 이름만 읽어도 충분

pom.xml (의존성) 읽는 법

파일 위치: spring-boot-starters/spring-boot-starter-web/pom.xml

<project>
    <dependencies>

        <!-- 1️⃣ 기본 스타터 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
            <!-- → "이 스타터도 기본으로 포함" -->
        </dependency>

        <!-- 2️⃣ 웹 개발에 필요한 라이브러리 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <!-- → "Spring의 웹 부분" -->
        </dependency>

        <!-- 3️⃣ 웹 서버 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
            <!-- → "톰캣 서버" -->
        </dependency>

        <!-- 4️⃣ 선택적 라이브러리 -->
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <optional>true</optional>
            <!-- → "있어도 되고 없어도 되는 라이브러리" -->
        </dependency>
    </dependencies>
</project>

읽을 때 물어봐야 할 것:

이 스타터에 몇 개의 라이브러리가 들어있나? → <dependency> 태그 세기
필수 라이브러리는 뭔가? → <optional>true</optional>가 없는 것들
선택적 라이브러리는 뭔가? → <optional>true</optional>가 있는 것들

Step 5: "직접 해보기!" - 실습하기 (30분)

실습 1: 웹 개발 설정 이해하기

목표: "Spring Boot가 웹 개발을 위해 뭘 자동 설정하는가" 이해

GitHub 저장소 열기
spring-boot-autoconfigure 폴더 열기
WebMvcAutoConfiguration.java 찾기 (Go to file 사용!)
파일 열고 읽기: @AutoConfiguration(after = ?) 찾기 / @ConditionalOnClass(?) 찾기 / @Bean 메서드 몇 개 있나 세기
WebMvcAutoConfigurationTests.java 찾기
테스트 메서드 이름들만 읽어보기

✅ 배우는 것: "Spring Boot가 웹을 위해 어떻게 자동 설정하는가"

실습 2: 스타터 구성 분석하기

목표: "각 스타터에 뭐가 들어있는가" 이해

spring-boot-starters 폴더 열기
spring-boot-starter-web 폴더 열기
pom.xml 파일 열기
<dependency>를 세어보기 ("아, 웹 스타터에 10개의 라이브러리가 들어있네")
spring-boot-starter-data-jpa도 비교해보기
자신의 프로젝트 pom.xml과 비교해보기

✅ 배우는 것: "스타터가 얼마나 많은 라이브러리를 제공하는가"

실습 3: 자신의 프로젝트와 연결하기

목표: "내 프로젝트가 Spring Boot에서 어떻게 자동 설정되는가" 이해

자신의 프로젝트 pom.xml 열기
사용 중인 스타터 찾기 (예: spring-boot-starter-web)
GitHub에서 그 스타터의 pom.xml 찾기
두 파일 비교하기: GitHub의 스타터에 뭐가 들어있나? / 내 프로젝트에는 추가로 뭐가 있나? / 왜 그 라이브러리들이 필요한가?
GitHub에서 그 기술의 자동 설정도 찾아보기 (예: WebMvcAutoConfiguration)

✅ 배우는 것: "내 프로젝트가 Spring Boot와 어떻게 연결되는가"

초보자가 자주 하는 실수 (꼭 피하기!)

❌ 실수 1: "main 브랜치만 본다"

GitHub의 main 브랜치는 "개발 중인 코드"이기 때문에 불안정할 수 있고 자신의 프로젝트 버전과 다를 수 있습니다.

해결방법:

자신의 Spring Boot 버전 확인 (pom.xml에서 <spring.boot.version>3.2.1</spring.boot.version>)
GitHub에서 같은 버전의 브랜치 선택 (Main ▼ 클릭 → "3.2.x" 찾기 → 클릭)
그 브랜치에서 파일 찾기

❌ 실수 2: "코드만 읽고 테스트는 안 본다"

JdbcAutoConfiguration.java만 읽으면 "이게 뭐 하는 건지" 정확히 모르고, 실제로 어떻게 사용되는지도 알 수 없습니다.

해결방법:

AutoConfiguration 파일 읽기: JdbcAutoConfiguration.java
테스트 파일도 반드시 읽기: JdbcAutoConfigurationTests.java
테스트를 읽으면 "아, 이렇게 작동하는구나"를 알 수 있다

❌ 실수 3: "한 파일을 완벽히 이해하려고 함"

한 파일에서 2~3시간을 쓰면 진도가 안 나가고 지루해져서 포기하게 됩니다.

해결방법:

"대략 이렇게 된다" 정도만 이해하기
못 이해하는 부분은 건너뛰기
다음 파일로 넘어가기

반복하다 보면 처음엔 60% 이해, 두 번째는 80% 이해, 세 번째는 완벽히 이해하게 됩니다.

❓ 자주 묻는 질문 (FAQ)

Q: 코드가 완벽히 이해가 안 돼도 괜찮나요?

A: 네, 완벽히 괜찮습니다! 처음엔 60% 이해하면 성공입니다. 반복해서 읽다 보면 자연스럽게 이해됩니다. 1주일 후 60% 이해, 2주일 후 80% 이해, 1개월 후 완벽히 이해하게 됩니다.

Q: 어디서부터 시작해야 할까요?

A: 자신의 프로젝트에서 사용하는 기술부터 시작하세요!

"웹 개발을 배우고 있다" → WebMvcAutoConfiguration부터
"데이터베이스를 배우고 있다" → JpaAutoConfiguration부터
"보안을 배우고 있다" → SecurityAutoConfiguration부터

Q: main 브랜치와 3.2.x 브랜치 중 뭘 봐야 할까요?

A: 자신의 Spring Boot 버전과 맞는 브랜치를 보세요! Spring Boot 3.2.1을 쓴다면 "3.2.x" 브랜치를 선택하고, 최신 기능을 배우고 싶다면 "main" 브랜치도 가능합니다.

Q: 테스트 코드가 복잡한데 어떻게 읽을까요?

A: 메서드 이름만 읽으면 됩니다! testJdbcTemplateBacksOff()는 "JdbcTemplate이 자동으로 생성된다"는 의미입니다. 테스트 메서드의 이름이 가장 중요하고, 코드 안의 세부 내용은 이해 안 해도 됩니다.

Q: 다른 폴더들은 언제 봐야 할까요?

A: 초보자는 일단 skip해도 됩니다! spring-boot-tests/는 3개월 후, docs/는 필요할 때 보세요. 먼저 할 일은 spring-boot-autoconfigure(자동 설정) → spring-boot-starters(의존성) → spring-boot(핵심) 순서입니다.

최종 조언: 시작하기 전에 기억할 것

완벽함을 목표로 하지 마세요. 초보자는 "대략 이렇게 된다" 정도 이해하면 성공입니다.
배운 걸 바로 써먹으세요. GitHub 읽기만 해선 안 됩니다. 자신의 프로젝트와 연결해야 진짜 이해됩니다.
반복 학습을 믿으세요. 1번 읽고 모르면 정상입니다. 계속 보다 보면 자연스럽게 이해됩니다.
테스트 코드를 활용하세요. "이 코드가 뭐 하는 건지 모르겠어" 할 때 테스트 파일을 보면 답이 있습니다.
한꺼번에 다 하려고 하지 마세요. 1주일에 3~4개 파일만 읽으면 OK. 꾸준히 하면 1개월 후에 엄청난 성장을 느낄 것입니다.

이 가이드를 다 읽고 할 일

Step 1: GitHub 저장소를 실제로 열어보기
Step 2: 폴더 구조를 확인하기
Step 3: 파일 검색 기능으로 1개 파일 찾기
Step 4: 찾은 파일을 읽어보기
Step 5: 테스트 파일도 찾아서 읽어보기
Step 6: 자신의 프로젝트와 비교해보기

1개월 후의 당신

✅ GitHub 저장소에서 파일을 찾을 수 있다
✅ AutoConfiguration 파일을 읽을 수 있다
✅ 테스트 코드로 작동 방식을 이해한다
✅ 자신의 프로젝트를 GitHub와 연결할 수 있다
✅ 새로운 기술을 배울 때 GitHub를 활용할 수 있다
✅ Spring Boot의 설계 철학을 이해한다
✅ "자신도 자동 설정을 만들어볼까?" 생각이 든다

유용한 링크

Spring Boot GitHub 저장소: https://github.com/spring-projects/spring-boot
Spring Boot 공식 문서: https://docs.spring.io/spring-boot/

시작하기 전 체크리스트

인터넷이 연결되어 있다
브라우저가 열려 있다
GitHub 계정이 있다 (없어도 괜찮지만, 있으면 좋음)
자신의 Spring Boot 프로젝트가 있다
자신의 프로젝트의 pom.xml 파일을 찾을 수 있다
이 가이드를 차근차근 따라가려고 마음먹었다

모든 게 준비됐다면? 이제 시작할 준비가 된 것입니다!

마지막 한 마디

"Spring Boot GitHub 저장소는 단순한 소스코드 모음이 아닙니다. 여기엔 Spring Boot를 만든 개발자들의 설계 철학, 모범 사례, 그리고 10년 이상의 경험이 담겨 있습니다."

이 저장소를 제대로 이해하면, 여러분의 Spring Boot 실력은 극적으로 향상될 것입니다. 처음엔 어렵지만, 차근차근 나아가다 보면 언젠가는 "아, 이래서 이렇게 설계했구나"를 깨달을 날이 올 것입니다.

이제 GitHub 저장소를 열고 첫 번째 파일을 찾아보세요! 처음 30분이 가장 어렵지만, 그 후로는 점점 쉬워질 것입니다.

Happy Learning!

Claude Design 사용법 총정리: 대화만으로 디자인하는 AI 도구 (2026)

zippy — Sat, 18 Apr 2026 19:17:57 +0900

2026년 4월, Anthropic이 또 한 번 판을 뒤집었습니다. 이번에는 디자인 영역입니다. Claude Design이라는 새로운 기능이 리서치 프리뷰로 공개되었는데, 한마디로 요약하면 "대화만으로 디자인을 완성하는 도구"입니다.

디자이너가 아니어도, Figma를 몰라도, 심지어 파워포인트에 자신이 없어도 괜찮습니다. Claude와 채팅하듯 대화하면 프로토타입, 프레젠테이션, 랜딩 페이지까지 뚝딱 만들어주니까요.

이 글에서는 Claude Design이 무엇인지, 어떻게 사용하는지, 그리고 실전에서 최대한 활용하는 팁까지 빠짐없이 정리했습니다.

1. Claude Design이란?

Claude Design은 Anthropic Labs가 만든 AI 기반 디자인 도구입니다. 채팅으로 원하는 것을 설명하면, Claude가 캔버스 위에 실제 작동하는 디자인을 생성해 줍니다. 정적인 이미지가 아니라 인터랙티브한 프로토타입, 프레젠테이션, 랜딩 페이지 등을 만들 수 있다는 점이 핵심입니다.

누가 사용할 수 있나요?

현재 리서치 프리뷰 단계로, Pro, Max, Team, Enterprise 플랜 사용자가 이용할 수 있습니다. 다만 Enterprise 플랜은 기본적으로 비활성화 상태이므로 관리자가 별도로 켜야 합니다.

화면 구성

화면은 크게 두 영역으로 나뉩니다.

영역	역할
왼쪽: 채팅 인터페이스	원하는 디자인을 설명하고, 수정 요청을 보내는 공간
오른쪽: 캔버스	Claude가 생성한 디자인이 실시간으로 표시되는 공간

채팅에서 설명하면 캔버스에 결과물이 나타나고, 다시 채팅이나 인라인 코멘트로 수정하는 반복 과정을 거칩니다.

2. 기본 작업 흐름 (5단계)

Claude Design의 전체 흐름은 다음과 같이 5단계로 요약됩니다.

① 프로젝트 생성 및 컨텍스트 추가

새 프로젝트를 만들면 조직의 디자인 시스템(브랜드 컬러, 폰트, 컴포넌트 패턴 등)이 자동으로 상속됩니다. 별도로 브랜드 에셋을 업로드하거나 설정할 필요가 없습니다.

프로젝트 생성 후, 컨텍스트(참고 자료)를 첨부하면 결과물의 품질이 크게 향상됩니다. 첨부 가능한 자료 유형은 다음과 같습니다.

자료 유형	활용 예시
스크린샷, 이미지, 기존 에셋	기존 디자인, 경쟁사 제품, 와이어프레임, 시각적 영감 자료, 기존 슬라이드 덱이나 문서
코드베이스, 디자인 파일	코드 저장소를 연결하면 기존 컴포넌트와 아키텍처, 스타일링 패턴을 파악하여 프로토타입이 더 프로덕션에 가깝게 만들어짐

팁: "이 느낌대로 만들어줘"라는 요청을 할 때 레퍼런스 스크린샷을 함께 첨부하면 효과가 극대화됩니다.

② 원하는 것을 설명 (프롬프트 작성)

디자이너가 아니어도 좋은 결과를 얻을 수 있습니다. 핵심은 구체적으로 작성하는 것입니다. 좋은 프롬프트에는 다음 4가지 요소가 포함됩니다.

목표(Goal): 무엇을 만들 것인지
레이아웃(Layout): 요소들이 어떻게 배치되어야 하는지
콘텐츠(Content): 어떤 정보를 표시할 것인지
대상(Audience): 누가 사용할 것인지

부족한 부분이 있으면 Claude가 추가 질문을 해주므로 처음부터 완벽할 필요는 없습니다.

프롬프트 예시:

유형	프롬프트
대시보드	"지역별, 제품 라인별 필터가 있는 월간 매출 대시보드를 만들어줘"
모바일 앱	"핵심 기능을 소개하는 4개 화면의 모바일 앱 온보딩 플로우를 디자인해줘"
랜딩 페이지	"히어로 섹션, 코드 예시, 가격 정보가 포함된 API 제품 랜딩 페이지를 만들어줘"
폼	"카테고리에 따라 질문이 달라지는 고객 피드백 수집 폼을 만들어줘"
내부 도구	"콘텐츠 제출물을 검토하고 승인하는 운영팀용 내부 도구를 디자인해줘"

③ 캔버스에서 결과 확인

프롬프트를 보내면 오른쪽 캔버스에 디자인이 생성됩니다. 이것은 시작점입니다. 여기서부터 진짜 작업이 시작됩니다.

④ 반복 수정 (Iteration)

수정 방법은 두 가지입니다.

방법 1: 채팅 (Chat)

전체적인 방향이나 구조를 바꿀 때 사용합니다.

"색상을 더 어둡고 미니멀하게 바꿔줘"
"대시보드 상단에 지표를 배치하고 차트는 아래로 내려줘"
"오른쪽에 설정 패널을 추가해줘"
"이 페이지의 대안 레이아웃을 2~3개 보여줘"

디자인 결정에 대한 설명을 요청하거나, 개선점 제안, 접근성 검토를 요청할 수도 있습니다.

방법 2: 인라인 코멘트 (Inline Comments)

캔버스의 특정 요소를 직접 클릭하여 세부 수정을 요청할 때 사용합니다. 위치를 채팅으로 설명할 필요가 없어 더 빠릅니다.

"이 버튼 패딩을 더 크게 해줘"
"여기를 라디오 버튼 대신 드롭다운으로 바꿔줘"
"여기에 브랜드 기본 색상을 적용해줘"
"이 섹션을 접을 수 있게 만들어줘"

⚠️ 알려진 이슈: 인라인 코멘트가 간헐적으로 Claude가 읽기 전에 사라지는 경우가 있습니다. 이럴 때는 코멘트 내용을 채팅에 직접 붙여넣기 하세요.

채팅 vs 인라인 코멘트, 언제 뭘 써야 할까?

상황	추천 방법
버튼 수정, 간격 조절 등 특정 컴포넌트 수정	인라인 코멘트
구조 변경, 새 섹션 추가, 전체 미학 변경, 설명이 필요한 요청	채팅

⑤ 내보내기 및 공유

디자인이 완성되면 오른쪽 상단의 Export 버튼을 눌러 다양한 형식으로 내보낼 수 있습니다.

내보내기 형식	추천 용도
.zip 다운로드	전체 프로젝트 파일을 로컬에 보관할 때
PDF	이메일 첨부, 지원서 제출, 인쇄용
PPTX	파워포인트에서 추가 편집이 필요할 때
Canva로 보내기	Canva에서 완전 편집 가능
독립형 HTML	웹 포트폴리오, 온라인 공유
Claude Code 핸드오프	개발팀에 전달하여 실제 코드로 구현할 때
로컬 코딩 에이전트로 전송	로컬 개발 환경에서 바로 작업 이어갈 때

또한 공유 링크를 생성하여 조직 내 동료에게 공유할 수 있으며, 보기 전용(view-only), 코멘트 가능, 편집 가능 등 접근 권한을 설정할 수 있습니다.

3. 버전 관리

디자인 방향을 완전히 바꿔보고 싶지만, 현재 작업물을 잃고 싶지 않을 때가 있습니다. 이때 Claude에게 다음과 같이 말하면 됩니다.

"지금까지 한 것을 저장하고, 완전히 다른 방향으로 시도해줘"

Claude가 현재 프로젝트를 저장하고 저장 위치를 알려주므로, 대화 중에 이전 버전을 쉽게 참조할 수 있습니다.

4. 실전 활용 팁 7가지

Claude Design을 최대한 잘 쓰기 위한 핵심 팁을 정리했습니다.

팁 1: 단순하게 시작하고, 점차 복잡도를 높여라

핵심 레이아웃과 콘텐츠부터 시작한 뒤, 인터랙션, 엣지 케이스, 세부 다듬기를 순차적으로 추가하세요. Claude는 점진적인 요청에 잘 반응합니다.

팁 2: 피드백은 구체적으로

❌ 나쁜 피드백	✅ 좋은 피드백
"이거 뭔가 이상해"	"폼 필드 사이 간격을 8px로 줄여줘"
"좀 더 예쁘게"	"액센트 컬러를 #4A90D9로 통일하고 여백을 넓혀줘"

팁 3: 디자인 시스템을 적극 활용하라

조직의 디자인 시스템에 특정 컴포넌트가 있다면, 이름을 직접 언급하세요. "Primary Button 컴포넌트를 사용해줘", "Card 레이아웃 패턴을 적용해줘" 같은 식입니다.

팁 4: 반응형 디자인은 초기에 언급하라

모바일, 태블릿, 데스크톱 중 어떤 환경을 지원해야 하는지 처음부터 알려주세요. 나중에 반응형을 추가하면 전체 구조를 뜯어고쳐야 할 수 있습니다.

팁 5: 변형안을 요청하라

방향이 확실하지 않을 때는 "이 페이지의 대안 레이아웃을 2~3개 보여줘"라고 요청하세요. 추측하며 하나를 고르는 것보다 비교하는 것이 훨씬 빠릅니다.

팁 6: Claude에게 피드백을 요청하라

Claude는 단순한 생성기가 아니라 디자인 협업 파트너입니다. 접근성, 대비율, 정보 위계, 전반적 사용성에 대한 리뷰를 요청할 수 있습니다.

팁 7: 레퍼런스 이미지를 꼭 첨부하라

"토스 같은 느낌으로", "구글 Material Design 스타일로"라고 말하는 것보다, 해당 디자인의 스크린샷을 직접 첨부하는 것이 훨씬 정확한 결과를 만듭니다.

5. 알려진 제한 사항

현재 실험적 프리뷰 단계이므로 몇 가지 제한이 있습니다.

이슈	해결 방법
인라인 코멘트가 사라짐	코멘트 내용을 채팅에 직접 붙여넣기
컴팩트 뷰에서 저장 오류	풀 뷰로 전환 후 다시 시도
대규모 코드베이스 연결 시 지연	전체 모노레포 대신 특정 하위 디렉토리만 연결
채팅 업스트림 오류	같은 프로젝트 내에서 새 채팅 탭 시작

6. 어떤 사람에게 유용할까?

Claude Design은 다음과 같은 분들에게 특히 유용합니다.

비디자이너: Figma나 Sketch를 배울 시간이 없는 기획자, 개발자, 마케터
1인 창업자/사이드 프로젝트: 디자이너 없이 빠르게 프로토타입을 만들어야 할 때
취업 준비생: 포트폴리오 슬라이드 덱을 전문적으로 만들고 싶을 때
스타트업 팀: 투자자 피치 덱, 랜딩 페이지를 빠르게 제작할 때
디자이너: 초기 아이디어를 빠르게 스케치하고 변형안을 탐색할 때

마무리

Claude Design은 "디자인은 디자이너만의 영역"이라는 고정관념을 깨는 도구입니다. 물론 아직 리서치 프리뷰 단계이고 알려진 제한 사항도 있지만, 대화만으로 프로토타입부터 프레젠테이션까지 만들 수 있다는 것 자체가 상당한 가능성을 보여줍니다.

특히 PPTX, PDF, Canva, HTML 등 다양한 내보내기 옵션을 지원하고, Claude Code로의 핸드오프까지 가능하다는 점에서 디자인에서 개발까지의 워크플로우를 하나의 도구 안에서 연결하려는 Anthropic의 방향성이 명확하게 드러납니다.

아직 사용해보지 않았다면, claude.ai/design에서 직접 체험해 보세요. Pro 플랜 이상이라면 지금 바로 시작할 수 있습니다.

인텔리제이 단축키 완벽 정리 | IntelliJ 환경설정 꿀팁 모음 (Windows/Mac)

zippy — Fri, 17 Apr 2026 14:27:37 +0900

개발하다 보면 마우스 클릭 한 번이 답답하게 느껴질 때가 있지 않으신가요?

IntelliJ IDEA는 전 세계 개발자가 가장 많이 사용하는 IDE 중 하나인데, 단축키와 환경설정을 제대로 알고 쓰는 것만으로도 코딩 속도가 눈에 띄게 달라집니다.

이 글에서는 윈도우(Windows)와 맥(Mac) 모두 커버하는 인텔리제이 핵심 단축키와 초기 환경설정 꿀팁을 한 번에 정리했습니다.

이 글을 읽으면 얻는 것

마우스 없이도 빠른 코딩: 필수 단축키 카테고리별 완벽 정리
처음 설치 후 바로 적용할 초기 환경설정: 자동 Import, 코드 스타일, 폰트 등
생산성을 2~3배 높이는 꿀팁: Live Template, 멀티 커서, 플러그인 추천까지

인텔리제이 단축키 - 기본 편집 (Editing)
인텔리제이 단축키 - 검색 및 이동 (Search & Navigation)
인텔리제이 단축키 - 리팩토링 (Refactoring)
인텔리제이 단축키 - 실행 & 디버깅 (Run & Debug)
인텔리제이 단축키 - Git/VCS 버전 관리
인텔리제이 환경설정 필수 세팅
인텔리제이 꿀팁 & 추천 플러그인

1. ✏️ 기본 편집 단축키 (Editing)

코딩 중 가장 자주 쓰는 편집 관련 단축키입니다. 처음엔 어색하더라도 일주일만 의식적으로 사용하면 손이 자연스럽게 움직입니다.

기능	Windows / Linux	Mac
기본 코드 자동 완성	`Ctrl + Space`	`⌃ Space`
스마트 코드 자동 완성	`Ctrl + Shift + Space`	`⌃⇧ Space`
문장 자동 완성 (if, for 등)	`Ctrl + Shift + Enter`	`⌘⇧↩`
퀵픽스 / Import 자동 추가	`Alt + Enter`	`⌥↩`
현재 라인 복사 (아래에 붙여넣기)	`Ctrl + D`	`⌘D`
현재 라인 삭제	`Ctrl + Y`	`⌘Delete`
라인 위/아래로 이동	`Alt + Shift + ↑/↓`	`⌥⇧↑/↓`
코드 정렬 (포맷팅)	`Ctrl + Alt + L`	`⌘⌥L`
Import 정리 (미사용 제거)	`Ctrl + Alt + O`	`⌃⌥O`
라인 단위 주석 처리	`Ctrl + /`	`⌘/`
블록 단위 주석 처리	`Ctrl + Shift + /`	`⌘⌥/`
선택 영역 확대	`Ctrl + W`	`⌥↑`
클립보드 히스토리에서 붙여넣기	`Ctrl + Shift + V`	`⌘⇧V`
Generate (생성자, getter 등)	`Alt + Insert`	`⌘N`
Override 메서드 목록	`Ctrl + O`	`⌃O`
Implement 메서드 목록	`Ctrl + I`	`⌃I`
대/소문자 변환	`Ctrl + Shift + U`	`⌘⇧U`
에디터 탭 닫기	`Ctrl + F4`	`⌘W`
전체 저장	`Ctrl + S`	`⌘S`
파라미터 정보 보기	`Ctrl + P`	`⌘P`

꿀팁: Alt + Enter는 단순히 Import 추가 외에도 오류 수정, 코드 개선 제안, null 처리 추가 등 다양한 상황에서 사용할 수 있습니다. 빨간 줄이 보이면 무조건 Alt + Enter를 먼저 눌러보세요!

2. 검색 및 이동 단축키 (Search & Navigation)

IntelliJ의 진짜 강점은 강력한 검색 기능입니다. 파일, 클래스, 메서드 어디서든 단 몇 번의 키 입력으로 도달할 수 있습니다.

기능	Windows / Linux	Mac
전체 검색 (Search Everywhere)	`Shift 두 번`	`⇧ 두 번`
액션 검색 실행	`Ctrl + Shift + A`	`⌘⇧A`
클래스로 이동	`Ctrl + N`	`⌘O`
파일로 이동	`Ctrl + Shift + N`	`⌘⇧O`
심볼(메서드, 변수 등) 검색	`Ctrl + Alt + Shift + N`	`⌘⌥O`
현재 파일에서 검색	`Ctrl + F`	`⌘F`
현재 파일에서 대체	`Ctrl + R`	`⌘R`
프로젝트 전체에서 검색	`Ctrl + Shift + F`	`⌘⇧F`
프로젝트 전체에서 대체	`Ctrl + Shift + R`	`⌘⇧R`
선언부로 이동	`Ctrl + B / Ctrl + Click`	`⌘B`
구현체로 이동	`Ctrl + Alt + B`	`⌘⌥B`
특정 라인으로 이동	`Ctrl + G`	`⌘L`
최근 열어본 파일 목록	`Ctrl + E`	`⌘E`
최근 편집한 파일 목록	`Ctrl + Shift + E`	`⌘⇧E`
이전/다음 편집 위치 이동	`Ctrl + Alt + ←/→`	`⌘⌥←/→`
파일 구조창 (메서드 목록)	`Ctrl + F12`	`⌘F12`
에디터 탭 이동	`Alt + ←/→`	`⌃←/→`
같은 단어 다중 선택	`Alt + J`	`⌃G`
모든 같은 단어 한 번에 선택	`Ctrl + Alt + Shift + J`	`⌃⌘G`

꿀팁: Shift 두 번의 Search Everywhere는 클래스, 파일, 심볼, 액션까지 한 번에 검색합니다. 창 상단 탭(All / Classes / Files / Symbols / Actions)을 Tab 키로 전환하면 더 정밀한 검색이 가능합니다.

3. 리팩토링 단축키 (Refactoring)

리팩토링 단축키는 코드 품질을 빠르게 개선하는 핵심 무기입니다. 특히 Shift + F6(이름 변경)은 프로젝트 전체의 참조까지 한 번에 바꿔줘서 실수를 크게 줄여줍니다.

기능	Windows / Linux	Mac
이름 변경 (Rename)	`Shift + F6`	`⇧F6`
리팩토링 메뉴 열기	`Ctrl + Alt + Shift + T`	`⌃T`
메서드로 추출	`Ctrl + Alt + M`	`⌘⌥M`
변수로 추출	`Ctrl + Alt + V`	`⌘⌥V`
상수로 추출	`Ctrl + Alt + C`	`⌘⌥C`
필드로 추출	`Ctrl + Alt + F`	`⌘⌥F`
파라미터로 추출	`Ctrl + Alt + P`	`⌘⌥P`
메서드 시그니처 변경	`Ctrl + F6`	`⌘F6`
안전 삭제 (Safe Delete)	`Alt + Delete`	`⌘Delete`
Surround with (try-catch 등)	`Ctrl + Alt + T`	`⌘⌥T`
다음 오류 위치로 이동	`F2`	`F2`
도큐먼트 조회	`Ctrl + Q`	`F1`

꿀팁: 드래그로 코드 블록을 선택한 뒤 Ctrl + Alt + M을 누르면 해당 코드가 자동으로 새 메서드로 추출됩니다. 긴 메서드를 쪼갤 때 매우 유용합니다.

4. ▶️ 실행 & 디버깅 단축키 (Run & Debug)

디버깅 단축키를 모르면 매번 마우스로 버튼을 클릭해야 합니다. 아래 단축키를 익혀두면 디버깅 속도가 크게 빨라집니다.

기능	Windows / Linux	Mac
프로젝트 실행	`Shift + F10`	`⌃R`
디버그 모드 실행	`Shift + F9`	`⌃D`
현재 파일 실행	`Ctrl + Shift + F10`	`⌃⇧R`
프로젝트 빌드	`Ctrl + F9`	`⌘F9`
브레이크포인트 설정/해제	`Ctrl + F8`	`⌘F8`
다음 라인으로 (Step Over)	`F8`	`F8`
메서드 안으로 (Step Into)	`F7`	`F7`
메서드 밖으로 (Step Out)	`Shift + F8`	`⇧F8`
다음 브레이크포인트로 (Resume)	`F9`	`⌘⌥R`
커서 위치까지 실행 (Run to Cursor)	`Alt + F9`	`⌥F9`
식 계산 (Evaluate Expression)	`Alt + F8`	`⌥F8`
프로그램 종료	`Ctrl + F2`	`⌘F2`
브레이크포인트 목록 보기	`Ctrl + Shift + F8`	`⌘⇧F8`

5. ️ Git / VCS 버전 관리 단축키

IntelliJ에는 Git 작업을 IDE 안에서 바로 처리할 수 있는 강력한 VCS 기능이 내장되어 있습니다.

기능	Windows / Linux	Mac
커밋 창 열기	`Ctrl + K`	`⌘K`
Push	`Ctrl + Shift + K`	`⌘⇧K`
Update (Pull)	`Ctrl + T`	`⌘T`
VCS 빠른 메뉴	Alt + `	`⌃V`
현재 파일 변경 내역 Rollback	`Ctrl + Alt + Z`	`⌘⌥Z`
테스트 생성/이동	`Ctrl + Shift + T`	`⌘⇧T`

6. ⚙️ 인텔리제이 환경설정 필수 세팅

인텔리제이를 처음 설치하거나 새로 세팅할 때 꼭 확인해야 할 환경설정 목록입니다. Ctrl + Alt + S (Mac: ⌘,)로 Settings 창을 열어 적용하세요.

① Auto Import 설정 (자동 Import)

Settings → Editor → General → Auto Import

Add unambiguous imports on the fly와 Optimize imports on the fly 두 항목을 모두 체크합니다. 클래스 사용 시 자동으로 import 문이 추가되고, 미사용 import는 자동으로 삭제됩니다.

② 대소문자 구분 해제 (Code Completion)

Settings → Editor → General → Code Completion

Match case를 체크 해제합니다. 소문자로 입력해도 대문자로 시작하는 클래스명이 자동완성에 노출되어 훨씬 편리해집니다.

③ 폰트 변경 (D2Coding 추천)

Settings → Editor → Font

한글 주석이 깨지지 않는 D2Coding 또는 JetBrains Mono 폰트를 권장합니다. Font Size는 14~16, Line height는 1.2 정도가 가독성이 좋습니다.

④ 에디터 줄 번호 표시

Settings → Editor → General → Appearance

Show line numbers를 체크합니다. 디버깅 시 줄 번호를 바로 확인할 수 있어 필수입니다.

⑤ 빌드 메모리 증량 (Heap Size 설정)

Help → Change Memory Settings

기본 750MB에서 2048MB(2GB) 이상으로 늘리면 대형 프로젝트에서 빌드 속도가 개선됩니다. 16GB RAM 이상이라면 4096MB도 추천합니다.

⑥ 테마 변경

Settings → Appearance & Behavior → Appearance

기본 Darcula (다크모드) 외에도 One Dark Theme 플러그인을 설치해 사용하면 눈 피로가 줄어듭니다. Ctrl + ` (Mac: ⌃`)으로 빠르게 테마를 전환할 수도 있습니다.

⑦ 패키지 트리 형식으로 보기

프로젝트 탐색기 상단 설정 아이콘 → Tree Appearance

Compact Middle Packages 체크 해제. 패키지 구조를 계층형으로 명확히 볼 수 있습니다.

⑧ Keymap 설정

Settings → Keymap

Eclipse나 VS Code에서 넘어온 분들이라면, 본인에게 익숙한 키맵 프리셋을 선택하거나 개별 단축키를 커스터마이징 할 수 있습니다.

7. 인텔리제이 꿀팁 & 추천 플러그인

꿀팁 모음

① Live Template 활용

psvm + Tab → public static void main(String[] args) {} 자동 생성
sout + Tab → System.out.println() 자동 생성
fori + Tab → for 반복문 자동 생성
Settings → Editor → Live Templates에서 자신만의 템플릿도 추가할 수 있습니다.

② 멀티 커서 (Multi Cursor)

같은 단어를 여러 곳에서 동시에 편집하고 싶다면 Alt + J (Mac: ⌃G)를 반복해서 눌러 다중 선택한 뒤 한 번에 수정하세요.

③ Search Everywhere로 설정 접근

Shift 두 번을 누른 뒤 원하는 설정 이름(예: "font", "keymap")을 검색하면 Settings 창 없이 바로 해당 설정으로 이동할 수 있습니다.

④ 클립보드 히스토리

Ctrl + Shift + V를 누르면 최근에 복사했던 여러 항목 목록이 나타납니다. 여러 개를 복사해두고 순서대로 붙여넣을 때 매우 유용합니다.

⑤ 에디터 화면 최대화

Ctrl + Shift + F12를 누르면 사이드 패널을 모두 숨기고 에디터만 전체 화면으로 볼 수 있습니다. 집중 코딩이 필요할 때 사용해보세요.

⑥ Run Anything

Ctrl 두 번을 누르면 "Run Anything" 창이 열려서 명령어나 실행 구성을 빠르게 실행할 수 있습니다.

마무리 정리

인텔리제이 단축키는 한꺼번에 다 외우려고 하면 오히려 역효과가 납니다. 매주 3~5개씩, 자주 마우스로 클릭하는 기능부터 단축키로 대체하는 방식으로 천천히 익혀가는 것이 가장 효과적입니다.

시작 추천 순서:

Alt + Enter (퀵픽스)
Shift 두 번 (전체 검색)
Ctrl + Alt + L (코드 정렬)
Shift + F6 (이름 변경)
Ctrl + E (최근 파일)

이 다섯 가지만 완전히 체화해도 개발 흐름이 눈에 띄게 빨라집니다. 이 글이 도움이 됐다면 북마크해두고 필요할 때마다 참고해보세요!

Git 명령어 완벽 가이드 | 초보자부터 협업까지 한 번에 끝내기

zippy — Fri, 17 Apr 2026 12:38:44 +0900

개발을 시작하면 누구나 처음 마주치는 것이 바로 Git입니다. "커밋이 뭐야?", "브랜치는 왜 쓰는 거야?" 라는 질문에서 시작해서, 팀 협업 중 머지 충돌로 멘붕을 겪기까지, Git은 모든 개발자의 필수 도구입니다. 이 글에서는 Git의 초기 설정부터 실무 협업까지, 꼭 알아야 할 핵심 명령어를 단계별로 완벽하게 정리합니다.

✅ Git이란? 왜 써야 할까?

Git은 분산형 버전 관리 시스템(DVCS, Distributed Version Control System)으로, 코드의 변경 이력을 기록하고 관리할 수 있게 해주는 도구입니다. Git을 사용하면 다음과 같은 이점이 있습니다.

변경 이력 추적: 누가, 언제, 무엇을 바꿨는지 기록됩니다
협업 용이성: 여러 명이 동시에 같은 프로젝트에서 작업할 수 있습니다
실수 복구: 이전 상태로 언제든지 되돌릴 수 있습니다
브랜치 전략: 기능별로 독립적인 작업 공간을 만들 수 있습니다

⚙️ 1단계: Git 초기 설정 (git config)

Git을 처음 설치했다면 가장 먼저 사용자 정보를 설정해야 합니다. 커밋 기록에 작성자 정보가 함께 남기 때문에 반드시 설정해야 하는 과정입니다.

# 사용자 이름 설정
git config --global user.name "홍길동"

# 이메일 설정
git config --global user.email "honggildong@example.com"

# 기본 브랜치명 설정 (main 권장)
git config --global init.defaultBranch main

# 설정 확인
git config --list

Tip: --global 옵션은 현재 사용자의 모든 저장소에 적용됩니다. 특정 프로젝트에만 적용하려면 해당 디렉토리에서 --local 옵션을 사용하세요.

2단계: 저장소 생성과 클론 (git init / git clone)

프로젝트를 시작하는 방법은 두 가지입니다. 새 저장소를 직접 만들거나, 기존 원격 저장소를 복제하는 것입니다.

# 새 로컬 저장소 초기화
git init

# 원격 저장소 복제 (GitHub 등)
git clone https://github.com/username/repository.git

# 특정 폴더명으로 클론
git clone https://github.com/username/repository.git my-folder

git init을 실행하면 현재 디렉토리에 .git 폴더가 생성되며, 이 폴더가 Git 저장소의 핵심 데이터를 모두 담고 있습니다.

3단계: 스테이징과 커밋 (git add / git commit)

Git의 작업 흐름은 크게 세 영역으로 나뉩니다.
작업 디렉토리(Working Directory), 스테이징 영역(Staging Area), 로컬 저장소(Local Repository)입니다.

# 특정 파일을 스테이징 영역에 추가
git add 파일명.txt

# 현재 디렉토리의 모든 변경 파일 추가
git add .

# 커밋 (변경 이력 저장)
git commit -m "feat: 로그인 기능 구현"

# add와 commit을 한 번에 (새 파일 제외)
git commit -am "fix: 버그 수정"

좋은 커밋 메시지 작성 규칙 (Conventional Commits)

feat: 새로운 기능 추가
fix: 버그 수정
docs: 문서 변경
style: 코드 포맷 변경 (기능 변경 없음)
refactor: 코드 리팩토링
test: 테스트 추가/수정
chore: 빌드 설정, 패키지 변경 등

4단계: 상태 확인과 로그 조회 (git status / git log)

현재 저장소 상태를 파악하고 커밋 이력을 확인하는 명령어입니다. 작업 중에 가장 자주 사용하는 명령어 중 하나입니다.

# 현재 작업 상태 확인
git status

# 커밋 이력 조회
git log

# 한 줄 요약으로 보기
git log --oneline

# 브랜치 그래프와 함께 보기
git log --oneline --graph --all

# 특정 파일의 변경 내용 비교
git diff 파일명.txt

# 스테이징된 변경 내용 비교
git diff --staged

5단계: 브랜치 전략 (git branch / git checkout / git switch)

브랜치(Branch)는 Git의 핵심 기능으로, 독립적인 작업 공간을 생성해 메인 코드를 안전하게 보호하면서 새로운 기능을 개발할 수 있게 해줍니다.

# 브랜치 목록 확인
git branch

# 새 브랜치 생성
git branch feature/login

# 브랜치 이동 (구버전 방식)
git checkout feature/login

# 브랜치 이동 (신버전 권장)
git switch feature/login

# 브랜치 생성 + 이동 동시에
git switch -c feature/login

# 브랜치 삭제
git branch -d feature/login

실무에서 많이 쓰는 브랜치 전략 (Git Flow)

main: 항상 배포 가능한 안정 버전
develop: 개발 통합 브랜치
feature/기능명: 기능 단위 개발 브랜치
hotfix/이슈명: 긴급 버그 수정 브랜치

6단계: 병합과 충돌 해결 (git merge / git rebase)

작업이 완료된 브랜치를 메인 브랜치에 합치는 과정입니다. 충돌(Conflict)이 발생할 수 있으니 차분하게 해결하는 방법을 익혀두는 것이 중요합니다.

# main 브랜치로 이동 후 병합
git switch main
git merge feature/login

# 병합 커밋 없이 직선 이력으로 병합
git merge --squash feature/login

# 리베이스 (커밋 이력을 깔끔하게 정리)
git rebase main

충돌 발생 시 해결 절차

충돌 파일 확인: git status로 충돌 파일 목록 확인
파일 편집: 충돌 마커(<<<<<<<, =======, >>>>>>>)가 있는 부분을 직접 수정
스테이징: git add 파일명으로 해결된 파일 추가
커밋: git commit으로 병합 완료

☁️ 7단계: 원격 저장소 연동 (git remote / git push / git pull)

로컬 저장소와 GitHub, GitLab 등의 원격 저장소를 연결하고 코드를 동기화하는 핵심 명령어입니다.

# 원격 저장소 연결
git remote add origin https://github.com/username/repo.git

# 연결된 원격 저장소 확인
git remote -v

# 로컬 커밋을 원격에 업로드
git push origin main

# 최초 업로드 시 upstream 설정 (이후엔 git push만 해도 됨)
git push -u origin main

# 원격 변경사항 가져오기 + 병합
git pull origin main

# 원격 변경사항만 가져오기 (병합 안 함)
git fetch origin

pull vs fetch 차이점: git pull은 원격 변경사항을 가져와 자동으로 현재 브랜치에 병합합니다. git fetch는 변경사항을 가져오기만 하고 병합은 수동으로 해야 합니다. 팀 협업에서는 충돌을 줄이기 위해 fetch 후 확인하고 병합하는 방식을 권장합니다.

⏪ 8단계: 되돌리기 명령어 (git restore / git reset / git revert)

실수했을 때 당황하지 않고 이전 상태로 되돌리는 방법입니다. 상황에 따라 적절한 명령어를 선택해야 합니다.

# 작업 디렉토리의 변경사항 취소 (스테이징 전)
git restore 파일명.txt

# 스테이징 취소 (작업 내용은 유지)
git restore --staged 파일명.txt

# 최근 N개 커밋을 취소 (이력 삭제, 주의!)
git reset --hard HEAD~1   # 변경사항도 삭제
git reset --soft HEAD~1   # 변경사항은 스테이징 유지

# 특정 커밋을 되돌리는 새 커밋 생성 (안전한 방법, 협업 시 권장)
git revert 커밋해시

⚠️ 주의: git reset --hard는 커밋 이력과 작업 내용 모두를 삭제합니다. 원격 저장소에 이미 push된 커밋을 reset하면 팀원과 충돌이 발생할 수 있으니, 협업 중에는 git revert를 사용하는 것이 안전합니다.

9단계: 임시 저장 (git stash)

작업 중 갑자기 다른 브랜치로 이동해야 할 때, 커밋하기 애매한 변경사항을 임시로 보관하는 명령어입니다.

# 현재 변경사항 임시 저장
git stash

# stash 목록 확인
git stash list

# 가장 최근 stash 복원 + 목록에서 제거
git stash pop

# 특정 stash 복원
git stash apply stash@{0}

# stash 삭제
git stash drop stash@{0}

️ 10단계: 태그 관리 (git tag)

릴리즈 버전이나 중요한 시점을 표시할 때 사용하는 태그 명령어입니다. GitHub에서 릴리즈 노트와 함께 자동으로 표시됩니다.

# 태그 목록 확인
git tag

# 간단한 태그 생성
git tag v1.0.0

# 주석 태그 생성 (릴리즈에 권장)
git tag -a v1.0.0 -m "첫 번째 정식 릴리즈"

# 원격 저장소에 태그 업로드
git push origin v1.0.0

# 모든 태그 한 번에 업로드
git push origin --tags

실무 협업 시나리오: Pull Request 흐름

실제 팀 프로젝트에서 Git을 활용하는 표준적인 협업 흐름입니다.

최신 코드 동기화: git pull origin main
기능 브랜치 생성: git switch -c feature/새기능
작업 후 커밋: git add . → git commit -m "feat: 새 기능 구현"
원격에 푸시: git push origin feature/새기능
PR 생성: GitHub에서 Pull Request 작성 및 코드 리뷰 요청
리뷰 반영: 피드백 수정 후 추가 커밋 및 푸시
병합: 승인 후 main 브랜치에 Merge
브랜치 정리: git branch -d feature/새기능

자주 쓰는 Git 명령어 치트시트

명령어	설명
git init	저장소 초기화
git clone [URL]	원격 저장소 복제
git status	현재 상태 확인
git add .	전체 변경사항 스테이징
git commit -m "메시지"	커밋 생성
git push origin main	원격에 업로드
git pull origin main	원격 변경사항 가져오기 + 병합
git branch	브랜치 목록 확인
git switch -c [브랜치명]	브랜치 생성 + 이동
git merge [브랜치명]	브랜치 병합
git log --oneline	커밋 이력 한 줄 보기
git stash	작업 임시 저장
git revert [해시]	커밋 안전하게 되돌리기
git tag -a v1.0.0	버전 태그 생성

마무리: Git 학습 로드맵

Git은 처음에는 낯설지만, 반복해서 쓰다 보면 자연스럽게 손에 익습니다. 아래 순서로 학습하면 효율적입니다.

기초 다지기: init, add, commit, status, log
브랜치 익히기: branch, switch, merge
원격 연동 연습: remote, push, pull, fetch
협업 시나리오 실습: PR 기반 워크플로우
고급 기능 탐구: rebase, stash, cherry-pick, bisect

이 가이드가 Git을 처음 배우는 분들에게 명확한 길잡이가 되길 바랍니다.
막히는 부분이 생기면 git --help 명령어나 공식 문서(git-scm.com)를 참고하세요.
꾸준히 쓰는 것이 가장 빠른 학습 방법입니다!

노션 단축키 완벽 가이드 2026 — 마크다운 서식부터 슬래시 명령어까지 한 번에 끝내기

zippy — Thu, 16 Apr 2026 17:42:38 +0900

노션(Notion)을 쓰면서 매번 마우스로 서식 버튼을 클릭하고 있다면, 단축키와 마크다운 문법을 모르고 있는 것입니다.
이 가이드 하나로 텍스트 편집, 블록 조작, 슬래시 명령어까지 완벽하게 정리해 드립니다.

마크다운이란? 노션에서 왜 중요한가

마크다운(Markdown)은 일반 텍스트를 서식이 있는 문서로 변환해 주는 간단한 경량 문법입니다. 읽기 쉽고 쓰기 쉬운 순수 텍스트 포맷을 사용하면서도 구조적으로 다양한 서식을 적용할 수 있다는 장점이 있습니다. 노션에서는 이 마크다운을 기본으로 지원하여, 복잡한 서식 메뉴 없이도 빠르게 문서를 작성할 수 있습니다.

특히 개발자들 사이에서 널리 사용되는 이 문법을 노션에서도 그대로 활용할 수 있어, GitHub, Velog, Postman 등 다양한 도구와 매끄럽게 연결됩니다. 핵심 규칙 하나: 모든 마크다운 문법 뒤에는 반드시 공백(Space)을 입력해야 정상적으로 작동합니다.

✍️ 텍스트 서식 단축키 (가장 많이 쓰는 것들)

텍스트를 선택한 상태에서 아래 단축키를 누르면 즉시 서식이 적용됩니다. Mac은 Cmd, Windows/Linux는 Ctrl을 사용합니다.

기능	Windows / Linux	Mac	마크다운 문법
굵게 (Bold)	Ctrl + B	Cmd + B	텍스트
기울임 (Italic)	Ctrl + I	Cmd + I	텍스트 또는 _텍스트_
밑줄 (Underline)	Ctrl + U	Cmd + U	(마크다운 미지원, 단축키 사용)
~~취소선 (Strikethrough)~~	Ctrl + Shift + S	Cmd + Shift + S	~텍스트~
인라인 코드	Ctrl + E	Cmd + E	`텍스트`
링크 추가	Ctrl + K	Cmd + K	(URL 붙여넣기도 가능)
댓글 달기	Ctrl + Shift + M	Cmd + Shift + M

마크다운으로 블록 만들기 (입력 즉시 변환)

새로운 줄이나 블록 시작 부분에 아래 기호를 입력하고 스페이스바를 누르면, 즉시 해당 블록으로 변환됩니다. 마우스 없이 키보드만으로 모든 블록을 생성할 수 있습니다.

입력 기호	생성되는 블록
# + Space	제목 1 (Heading 1) - 가장 큰 제목
## + Space	제목 2 (Heading 2) - 중간 크기 제목
### + Space	제목 3 (Heading 3) - 소제목
- 또는 * + Space	글머리 기호 목록 (Bullet List)
1. + Space	번호 매기기 목록 (Numbered List)
[] + Space	할 일 체크박스 (To-do List)
> + Space	토글 목록 (Toggle)
" + Space	인용 블록 (Quote)
--- (대시 3개)	구분선 (Divider)
백틱 3개 (` ` `)	코드 블록 (Code Block)

팁: 코드 블록 생성 후 언어 이름을 입력하면 문법 강조(Syntax Highlighting)가 자동으로 적용됩니다.

⚡ 페이지 탐색 및 기본 단축키

페이지 간 빠른 이동과 워크스페이스 탐색에 필수적인 단축키들입니다. 이것만 알아도 업무 속도가 눈에 띄게 빨라집니다.

Ctrl/Cmd + N: 새 페이지 만들기
Ctrl/Cmd + P: 검색창 열기 / 최근 페이지 이동
Ctrl/Cmd + [: 이전 페이지로 뒤로가기
Ctrl/Cmd + ]: 다음 페이지로 앞으로가기
Ctrl/Cmd + Shift + N: 새 Notion 창 열기 (데스크톱 앱 전용)
Ctrl/Cmd + Shift + L: 다크 모드 / 라이트 모드 전환
Ctrl/Cmd + +: 페이지 확대
Ctrl/Cmd + -: 페이지 축소
Ctrl/Cmd + Shift + U: 상위 페이지로 이동

블록 선택 및 편집 단축키

노션의 모든 콘텐츠는 블록(Block) 단위로 구성됩니다. 텍스트 한 줄, 이미지, 임베드 모두 각각 하나의 블록입니다. 아래 단축키로 블록을 빠르게 조작할 수 있습니다.

Esc: 현재 블록 선택 (편집 모드에서 선택 모드로 전환)
Ctrl/Cmd + D: 선택한 블록 복제(Duplicate)
Ctrl/Cmd + Shift + ↑ / ↓: 선택한 블록 위/아래로 이동
Backspace / Delete: 선택한 블록 삭제
Ctrl/Cmd + /: 선택한 블록 유형 변경 (텍스트를 제목, 체크박스 등으로 전환)
Tab: 블록 들여쓰기 (하위 블록으로 만들기)
Shift + Tab: 블록 내어쓰기 (상위 블록으로 복귀)
Ctrl/Cmd + Shift + H: 마지막으로 사용한 색상 재적용
Ctrl/Cmd + Enter: 현재 블록 수정 (체크박스 토글, 이미지 전체화면 등)
Shift + 방향키: 인접한 블록을 함께 선택
Ctrl/Cmd + A (두 번 누르기): 페이지 전체 블록 선택
Ctrl/Cmd + Shift + ↑↓ (Alt 키 포함): 모든 토글 목록 펼치거나 닫기

⌨️ 텍스트 입력 편의 단축키

글을 작성하면서 자주 쓰이는 입력 관련 단축키입니다. 특히 줄 바꿈과 관련된 것들은 실수 없이 알아 두는 것이 좋습니다.

Enter: 새 텍스트 블록(새 줄) 삽입
Shift + Enter: 같은 블록 안에서 줄 바꿈 (블록을 나누지 않음)
Ctrl/Cmd + Z: 실행 취소 (Undo)
Ctrl/Cmd + Shift + Z: 다시 실행 (Redo)
Ctrl/Cmd + C: 복사, Ctrl/Cmd + V: 붙여넣기
Ctrl/Cmd + Shift + V: 서식 없이 순수 텍스트로 붙여넣기

@ 멘션과 [[]] 링크 명령어

노션에서 @ 기호 하나로 팀원, 페이지, 날짜를 모두 연결할 수 있습니다.

@이름: 워크스페이스 멤버 멘션 (알림 발송)
@페이지 제목: 해당 페이지로 이동하는 인라인 링크 생성 (페이지 제목 변경 시 링크 자동 업데이트)
@오늘 / @내일 / @다음 주 수요일: 날짜 삽입 및 리마인더 설정
[[페이지 제목]]: 페이지 링크 빠르게 삽입하기
+페이지 제목: 새 페이지 또는 하위 페이지 빠르게 생성

️ 슬래시(/) 명령어 완전 정복

빈 줄에서 /를 입력하면 노션의 모든 블록과 기능을 검색해서 삽입할 수 있습니다. 슬래시 명령어는 노션 기능의 시작점입니다. 원하는 블록 이름을 이어서 입력하면 더 빠르게 검색됩니다.

명령어	생성되는 블록 / 기능
/제목1, /h1	Heading 1 제목 블록
/할일, /todo	체크박스 할 일 목록
/토글, /toggle	토글(접기/펼치기) 목록
/구분선, /divider	회색 구분선
/인용, /quote	인용 블록 (큰 글씨)
/코드, /code	코드 블록 (언어 선택 가능)
/테이블, /table	인라인 테이블
/목차, /toc	목차 블록 자동 생성
/이미지, /image	이미지 업로드 / Unsplash 연동
/동영상, /video	YouTube, Vimeo 임베드
/북마크, /bookmark	URL을 미리보기 카드로 저장
/임베드, /embed	500가지 이상 외부 서비스 임베드
/수학 블록, /math	TeX 수식 블록
/버튼, /button	템플릿 버튼 (블록 조합 반복 생성)
/이동 경로, /breadcrumb	현재 페이지 위치 경로 표시
/날짜, /date	날짜 기록 및 리마인더 설정
/이모지, /emoji	이모지 선택창 열기
/PDF	PDF URL을 인라인으로 표시
/파일, /file	파일 업로드 / 임베드

Esc 키를 누르면 슬래시 명령어 메뉴를 닫고 /를 일반 텍스트로 입력할 수 있습니다.

️ 데이터베이스 단축키

노션의 핵심 기능인 데이터베이스에서도 단축키를 활용하면 훨씬 빠르게 작업할 수 있습니다.

Enter 또는 Tab: 셀 편집 모드 진입
Shift + Enter: 새 행 추가
Ctrl/Cmd + 클릭: 다중 행/카드 선택
Ctrl/Cmd + /: 다중 선택된 행을 한 번에 편집

생산성을 2배로 높이는 꿀팁 5가지

블록 유형 즉시 변환: 이미 작성한 텍스트를 제목이나 체크박스로 바꾸고 싶다면, 블록을 선택하고 Ctrl/Cmd + /를 누른 뒤 원하는 유형을 입력하면 됩니다. 다시 쓸 필요가 없습니다.
서식 없이 붙여넣기: 외부에서 복사한 텍스트에 불필요한 서식이 묻어 오면 Ctrl/Cmd + Shift + V로 순수 텍스트만 붙여넣을 수 있습니다.
이모지 빠르게 삽입: 텍스트 중간에 : + 이모지 이름 (예: :사과:)를 입력하면 이모지가 바로 삽입됩니다. Mac에서는 Ctrl + Cmd + Space로 이모지 피커를 열 수 있습니다.
글자색/배경색 변경: 슬래시 명령어 뒤에 색 이름을 입력하면 됩니다 (예: /파란색, /노란색 배경). 기본값으로 돌리려면 /기본색을 입력하세요.
Option/Alt 드래그로 블록 복제: 블록을 드래그할 때 Option(Mac) / Alt(Windows) 키를 함께 누르면 이동이 아닌 복제가 됩니다. 반복 구조를 빠르게 만들 때 유용합니다.

한눈에 보는 마크다운 서식 치트시트

목적	마크다운 문법	키보드 단축키
굵게	텍스트	Ctrl/Cmd + B
기울임	텍스트 또는 _텍스트_	Ctrl/Cmd + I
굵은 기울임	텍스트	Ctrl/Cmd + B & I
취소선	~텍스트~	Ctrl/Cmd + Shift + S
인라인 코드	`텍스트`	Ctrl/Cmd + E
제목 1	# + Space	Ctrl/Cmd + Alt + 1
제목 2	## + Space	Ctrl/Cmd + Alt + 2
제목 3	### + Space	Ctrl/Cmd + Alt + 3
할 일 목록	[] + Space	Ctrl/Cmd + Alt + 4
글머리 기호	- 또는 * + Space	Ctrl/Cmd + Alt + 5
번호 목록	1. + Space	Ctrl/Cmd + Alt + 6
토글	> + Space	Ctrl/Cmd + Alt + 7
인용 블록	" + Space	/인용
코드 블록	``` (백틱 3개)	Ctrl/Cmd + Alt + 8
구분선	--- (대시 3개)	/구분선

마치며: 단축키 습관화가 핵심

처음에는 단축키를 외우는 것이 부담스러울 수 있습니다. 하지만 한 번에 다 외우려 하지 말고, 오늘은 텍스트 서식 단축키(Ctrl + B, I, U), 내일은 블록 생성 마크다운(#, -, [], >), 이렇게 하루에 3~5개씩 몸에 익히는 방법을 추천합니다. 단축키와 마크다운을 제대로 활용하는 순간, 노션은 단순한 메모 앱이 아닌 진짜 강력한 생산성 도구로 탈바꿈됩니다.

이 글이 도움이 됐다면 북마크 해두고, 필요할 때마다 꺼내 보는 치트시트로 활용해 보세요!

파워포인트 단축키 총정리 | 실무에서 바로 쓰는 PPT 꿀팁 모음 | 이미지 공유

zippy — Thu, 16 Apr 2026 16:47:37 +0900

파워포인트 단축키 총정리! 기본 필수 단축키부터 발표 중 쓰는 슬라이드 쇼 단축키, 개체 정렬·서식 복사 꿀팁까지. 실무에서 바로 써먹는 PPT 단축키 모음으로 업무 속도를 2배 높여보세요. 가장 유용하게 쓰이는 파워포인트 단축키 이미지도 저장해서 활용하세요!

⚡ 기본 중의 기본, 필수 단축키

파워포인트를 처음 배우든, 오래 써왔든 반드시 알아야 할 기초 단축키입니다. 이것만 외워도 작업 속도가 눈에 띄게 달라집니다.

Ctrl + S: 저장 (수시로 눌러주는 습관이 중요합니다!)
Ctrl + Z: 실행 취소
Ctrl + Y: 다시 실행
Ctrl + C / V / X: 복사 / 붙여넣기 / 잘라내기
Ctrl + D: 개체 빠른 복제 (복사+붙여넣기를 한 번에!)
Ctrl + A: 전체 선택
Ctrl + Z: 실행 취소 (최대 20단계 이상 가능)

슬라이드 쇼 관련 단축키

발표 중에 당황하지 않으려면 슬라이드 쇼 단축키는 필수입니다. 청중 앞에서 마우스를 헤매는 상황을 방지해줍니다.

F5: 처음부터 슬라이드 쇼 시작
Shift + F5: 현재 슬라이드부터 슬라이드 쇼 시작
숫자 + Enter: 해당 번호 슬라이드로 바로 이동 (예: 5 + Enter → 5번 슬라이드)
B: 화면을 검정으로 전환 (잠깐 화면을 가릴 때)
W: 화면을 흰색으로 전환
Esc: 슬라이드 쇼 종료
Ctrl + P: 발표 중 펜 도구 활성화 (화면에 직접 필기 가능)
E: 펜으로 그린 내용 지우기

개체(도형, 텍스트박스) 정렬 꿀팁

디자인 작업에서 개체를 깔끔하게 정렬하는 것은 완성도를 높이는 핵심입니다. 마우스로 하나씩 맞추지 말고 단축키를 활용하세요.

Ctrl + G: 선택한 개체들 그룹화
Ctrl + Shift + G: 그룹 해제
방향키: 개체를 조금씩 이동
Ctrl + 방향키: 개체를 아주 미세하게 이동 (픽셀 단위)
Shift + 드래그: 수평/수직으로만 이동 (삐뚤어짐 방지)
Ctrl + Shift + 드래그: 가로/세로 비율 유지하며 크기 조정
Tab: 슬라이드 내 다음 개체로 포커스 이동
Shift + Tab: 슬라이드 내 이전 개체로 포커스 이동

✏️ 텍스트 편집 단축키

텍스트를 빠르게 꾸미고 편집하는 단축키입니다. 서식 도구 메뉴를 클릭하는 것보다 훨씬 빠릅니다.

Ctrl + B: 굵게(Bold)
Ctrl + I: 기울임꼴(Italic)
Ctrl + U: 밑줄(Underline)
Ctrl + E: 가운데 정렬
Ctrl + L: 왼쪽 정렬
Ctrl + R: 오른쪽 정렬
Ctrl + ]: 글자 크기 1pt 키우기
Ctrl + [: 글자 크기 1pt 줄이기
Ctrl + Shift + >: 글자 크기 크게
Ctrl + Shift + <: 글자 크기 작게
F2: 선택된 텍스트박스 편집 모드로 진입
Esc: 텍스트 편집 모드 → 개체 선택 모드로 전환

️ 슬라이드 관리 단축키

슬라이드가 많아질수록 전체 흐름을 빠르게 관리하는 단축키가 빛을 발합니다.

Ctrl + M: 새 슬라이드 추가
Ctrl + Enter: 다음 텍스트 상자로 이동 (제목 입력 후 내용으로 바로 이동)
Ctrl + Shift + D: 슬라이드 복제
Delete: 선택한 슬라이드 삭제
Ctrl + 위/아래 방향키: 슬라이드 순서 이동

보기 및 화면 관련 단축키

작업 환경을 빠르게 전환하면 편집 흐름이 끊기지 않아 집중력을 유지할 수 있습니다.

Ctrl + +: 화면 확대
Ctrl + -: 화면 축소
Ctrl + Shift + H: 슬라이드 마스터 보기
Alt + F9: 안내선(가이드라인) 표시/숨기기
Shift + F9: 눈금자 표시/숨기기
Alt + W + Q: 확대/축소 설정 창 열기

서식 복사 꿀팁: F4 & 서식 복사

서식을 여러 개체에 동일하게 적용하고 싶을 때 가장 많이 쓰는 꿀팁입니다.

F4: 바로 직전에 수행한 작업 반복 (색상 변경, 크기 조정 등을 여러 개체에 반복 적용할 때 최고!)
Ctrl + Shift + C: 서식 복사
Ctrl + Shift + V: 서식 붙여넣기
Ctrl + Alt + V: 선택하여 붙여넣기 (이미지, 텍스트 등 형식 선택 가능)

실무에서 특히 유용한 꿀팁 3가지

단축키와 함께 알아두면 업무 효율이 훨씬 올라가는 실전 팁들입니다.

Shift 키 활용: 도형을 그릴 때 Shift를 누르면 정원/정사각형이 만들어집니다. 직선을 그을 때도 Shift를 누르면 수평/수직/45도 직선이 만들어집니다.
Ctrl + 드래그로 빠른 복제: 개체를 선택한 뒤 Ctrl을 누른 채 드래그하면 그 자리에서 바로 복제됩니다. Ctrl + D보다 위치 지정이 자유롭습니다.
Alt 키로 미세 조정: 개체가 눈금에 자꾸 달라붙을 때, Alt 키를 누른 채 이동하면 눈금 스냅 없이 자유롭게 배치할 수 있습니다.

전체 단축키 요약표

카테고리	단축키	기능
기본	Ctrl + D	개체 복제
기본	Ctrl + Z / Y	실행 취소 / 다시 실행
슬라이드 쇼	F5 / Shift + F5	처음부터 / 현재부터 시작
슬라이드 쇼	B / W	화면 검정 / 흰색 전환
텍스트	Ctrl + ] / [	글자 크기 1pt 조정
텍스트	F4	마지막 작업 반복
개체	Ctrl + G / Ctrl + Shift + G	그룹화 / 그룹 해제
개체	Ctrl + 방향키	미세 이동
슬라이드	Ctrl + M	새 슬라이드 추가
서식	Ctrl + Shift + C/V	서식 복사 / 붙여넣기

⌨️ 가장 많이 사용하는 PPT 단축키 이미지 공유

가장 유용하게 쓰이는 파워포인트 단축키 이미지도 함께 공유합니다. 20개 또는 30개 원하는 이미지 다운받아 사용하세요.

가장 많이 사용하는 PPT 단축키 20선 이미지 공유 : 저장해서 사용하세요

ppt_shortcut.jpg

0.76MB

PPT_파워포인트_필수_단축키_30선.png

3.99MB

️ AWS EC2 리눅스 필수 명령어 총정리 (초보자부터 실무까지)

zippy — Fri, 10 Apr 2026 16:46:17 +0900

AWS EC2 인스턴스를 운영하면서 반드시 알아야 할 리눅스 명령어를 카테고리별로 정리했습니다. 서버 접속부터 프로세스 모니터링, 로그 관리까지 실무에서 바로 사용할 수 있는 명령어 모음입니다.

기본 단축키 및 명령어

명령어/단축키	설명
`cd ~/`	사용자 홈 폴더로 이동
`Ctrl + X`	nano 편집기 종료
`select-editor`	기본 에디터 선택 설정

1. 서버 접속 / 기본 탐색

# EC2 인스턴스 SSH 접속 (키파일, 사용자, IP, 포트 지정)
ssh -i "my-key.pem" ec2-user@13.124.1.2 -p 22

# 현재 세션을 루트로 전환 (환경변수 포함)
sudo su -

# 숨김파일 포함 상세 목록, 색상 표시
ls -la --color=auto /var/log/

# 현재 작업 디렉토리 물리적 경로 출력
pwd -P

# 물리적 경로로 디렉토리 이동 (심볼릭링크 해석)
cd -P /opt/tomcat10/webapps/

# 최근 20개 명령어 중 yum 관련 검색
history 20 | grep yum

# 화면 지우고 현재 사용자/UID/GID 확인
clear && whoami && id

# 현재 셸 종료 (SSH 연결 끊기)
exit

2. 시스템 업데이트 / 패키지 관리

# Amazon Linux 전체 패키지 업데이트
sudo yum update -y && sudo yum upgrade -y

# Ubuntu 패키지 업데이트 (설정파일 기존 유지)
sudo apt update && sudo apt upgrade -y -o Dpkg::Options::="--force-confold"

# 여러 패키지 한번에 설치
sudo yum install -y java-11-openjdk-devel tomcat httpd wget curl

# 패키지 삭제 + 의존성 자동 정리
sudo yum remove -y httpd && sudo yum autoremove -y

# 설치된 Tomcat 패키지 변경로그 확인
rpm -qa | grep -i tomcat | xargs rpm -q --changelog | head -20

# 설치된 Java 관련 패키지 개수 확인
sudo yum list installed | grep -i java | wc -l

# Tomcat 10 관련 사용가능 패키지 검색
sudo yum search tomcat | grep 10

# 활성화된 Yum/DNF 저장소 목록 (Amazon Linux 2023)
dnf repolist --enabled | grep amazon

3. 서비스 관리

# 모든 서비스 상태 중 웹서버만 필터링
service --status-all | grep -E "(tomcat|httpd)"

# Tomcat 10 서비스 중지 (SysV init 호환)
sudo service tomcat10 stop

# Tomcat 10 서비스 시작
sudo service tomcat10 start

# Tomcat 10 서비스 재시작
sudo service tomcat10 restart

# Tomcat 관련 모든 systemd 유닛 파일 목록
sudo systemctl list-unit-files | grep -i tomcat

# Tomcat 10 상세 상태 (전체로그, 페이지 안함)
sudo systemctl status tomcat10 -l --no-pager

# Tomcat 10 즉시 재시작
sudo systemctl restart tomcat10 --now

# Tomcat 10 부팅시 자동시작 + 즉시 시작
sudo systemctl enable tomcat10 --now

# systemd 설정 다시로드 후 재시작
sudo systemctl daemon-reload && sudo systemctl restart tomcat10

# Tomcat 10 실시간 로그 확인
journalctl -u tomcat10 -f --no-pager

4. 네트워크 / 포트 진단

# 8080 포트 리스닝 프로세스 확인 (TCP만)
netstat -nlpt | grep :8080

# 모든 리스닝 포트 상세 정보 (netstat 대체)
sudo ss -tuln | grep LISTEN

# 80/443/8080 포트별 프로세스/PID 확인
sudo ss -tulnp | grep -E ":(80|443|8080)"

# Tomcat Manager 상태 API 테스트 (SSL 무시)
curl -I -k https://localhost:8443/manager/status/all

# 웹서버 응답시간/상태 테스트
wget --spider --timeout=10 http://localhost:8080/ 2>&1 | grep HTTP

# EC2 메타데이터 서비스 연결 테스트
ping -c 4 169.254.169.254

# 방화벽 규칙 확인 (숫자IP, 통계 포함)
sudo iptables -L -n -v | grep -E "ACCEPT|DROP"

# TCP TIME_WAIT 연결 수 확인 (연결 누수 진단)
sudo netstat -anp | grep TIME_WAIT | wc -l

5. 프로세스 / 성능 모니터링

# Tomcat/Java 프로세스 상세 정보
ps aux | grep -E "(tomcat|java)" | grep -v grep

# Java 프로세스별 /proc 디렉토리 정보
ps -ef | grep java | awk '{print $2}' | xargs -r sudo ls -l /proc/

# Tomcat 프로세스만 top 모니터링 (1회)
top -p $(pgrep -d, tomcat) -n 1

# 메모리 실시간 모니터링 (3초 간격)
free -h -s 3

# 디스크 상세 표 형식 출력
df -h --output=source,fstype,size,used,avail,pcent,target

# 로그 디렉토리 크기순 정렬 (상위 10개)
du -sh /var/log/* | sort -hr | head -10

# 시스템 부하 + VM 통계 (5초 5회)
uptime && vmstat 1 5

# 디스크 I/O 통계 (5초 5회)
iostat -x 1 5 | grep -E "(avg-cpu|Device:)"

6. 파일 / 로그 관리

# Tomcat 로그 실시간 확인 (최근 200줄)
tail -f -n 200 /var/log/tomcat10/catalina.out

# 오류 로그 색상 하이라이트 검색
grep -i "ERROR|FATAL|OutOfMemory" /var/log/tomcat10/*.log --color=auto

# 어제 생성된 100MB 이상 로그파일 목록
find /var/log -name "*.log" -mtime -1 -size +100M -exec ls -lh {} \;

# 임시파일 안전 삭제 (에러 무시)
sudo rm -rf /tmp/* /var/tmp/* 2>/dev/null

# Tomcat 백업 (로그 제외, 날짜명)
sudo tar -czf /backup/tomcat-$(date +%Y%m%d).tar.gz /opt/tomcat10/ --exclude=/opt/tomcat10/logs

# Tomcat 디렉토리 소유권/권한 일괄 변경
sudo chown -R tomcat:tomcat /opt/tomcat10/ && sudo chmod -R 755 /opt/tomcat10/

# SSH 키파일 보안 권한 설정
sudo chmod 400 ~/.ssh/my-key.pem && sudo chmod 700 ~/.ssh/

# 페이지캐시 강제 해제 (메모리 부족시)
echo "0" | sudo tee /proc/sys/vm/drop_caches

⭐ 초보자 TOP 10 필수 명령어

가장 자주 사용하는 명령어를 우선순위별로 정리했습니다. 이것만 먼저 익혀두세요!

순위	명령어	설명
1	`ssh -i key.pem ec2-user@IP`	EC2 접속 (가장 중요!)
2	`sudo su -`	루트 권한 획득
3	`ls -la`	파일/폴더 목록 확인
4	`cd 경로`	디렉토리 이동
5	`pwd`	현재 위치 확인
6	`tail -f 로그파일`	로그 실시간 확인
7	`ps aux \| grep 이름`	프로세스 확인
8	`sudo systemctl status 서비스`	서비스 상태 확인
9	`df -h`	디스크 공간 확인
10	`sudo yum update -y`	시스템 업데이트 (Amazon Linux)

Tip: 명령어가 기억나지 않을 때는 history | grep 키워드로 이전에 사용한 명령어를 검색할 수 있습니다.

⚠️ 주의: sudo rm -rf는 복구가 불가능합니다. 경로를 반드시 확인한 후 실행하세요!

게으른 자들을 위한 알짜배기 압축집.zip

오라클 클라우드 과금 방지 가이드 (무료 인스턴스 PAYG 전환 후 설정)

목차

1. 오라클 무료 계정의 과금 구조 이해

Free Tier vs PAYG

2. 현재 리소스 점검 (과금 대상 여부 확인)

2-1. Always Free 리소스 한도

2-2. 인스턴스 Shape 확인 방법

2-3. 부트 볼륨 확인

2-4. 기타 리소스 확인

3. 예산(Budget) 생성 및 경보 규칙 설정

3-1. 예산 생성 화면 진입

3-2. 예산 기본 정보 입력

3-3. 첫 번째 경보 규칙 설정

3-4. 추가 경보 규칙 2개 더 만들기

4. 비용 분석(Cost Analysis)으로 현재 비용 확인

5. 카드 해외결제 한도 제한 (추가 안전장치)

설정 방법

6. 앞으로 지켜야 할 규칙 요약

해야 할 것

절대 하지 말아야 할 것

정기 점검 루틴

마무리

"AI가 기억하는 나" — 대화 기록을 기반으로 내 모습을 그리게 하는 프롬프트 공유

AI가 기억하는 나의 진짜 모습은 어떨까?

대화 기록으로 뽑아보는 'AI가 기억하는 나'

바로 복붙 가능한 프롬프트

활용 팁 & 결과를 더 잘 뽑는 방법

나의 대화 기록으로 뽑아낸 페르소나 이미지

[유행 따라잡기] 크레파스로 낙서한 느낌의 프롬프트 공유

️ 프롬프트

이 스타일, 이럴 때 쓰면 좋아요

혹시 결과가 너무 깔끔하게 나오나요?

비하인드: 사실 '무서운(?)' 실패작도 있었습니다...

CCleaner 구독 취소 방법, Cleverbridge 참조번호 찾는 법까지 총정리

왜 이렇게 복잡한가?

사전 준비물

1단계: Cleverbridge에서 구매 내역 조회하기

2단계: 이메일에서 참조번호 확인하기

3단계: CCleaner 구독 관리 페이지에서 정보 입력하기

4단계: 자동 갱신 비활성화(구독 취소) 완료하기

[Windows 11] 홈(Home) 버전 그룹 정책 편집기(gpedit.msc) 1분 만에 활성화하는 방법

1. 명령 프롬프트(CMD)로 한 번에 활성화하기 (추천)

2. 배치 파일(.bat)을 만들어서 실행하기

3. 제대로 설치되었는지 확인하기

Windows 11 전체 서비스 기능 설명 및 상태 설정 총정리

권장 상태 범례

A ~ D 분류 서비스 목록

E ~ N 분류 서비스 목록

O ~ S 분류 서비스 목록

T ~ Z 분류 서비스 목록

기타 한글 명칭 서비스 목록

마무리 요약

윈도우11 서비스 최적화 완벽 가이드: 불필요한 서비스 끄기 추천 목록

잠깐! 시작하기 전에 '안전벨트' 먼저 매고 갈까요?

1. 윈도우 서비스 설정 방법

2. 필수 비활성화(사용 안 함) 추천 목록

3. ⚙️ 시스템 핵심 유지 권장 목록 (수동/자동)

마치며

[Java] 람다식(Lambda Expression) 완전 정리 - 문법부터 Stream API 실전 활용까지

목차

1. 람다 함수(Lambda Expression) 개요

기본 문법

문법 변형 정리

주요 특징

2. 함수형 인터페이스 (Functional Interface)

Function 계열: 입력 값을 받아 출력 값을 반환

Predicate 계열: 입력값에 대해 조건을 검사하고 boolean을 반환

Consumer 계열: 입력값을 받아 처리만 하고 반환 없음 (void)

Supplier 계열: 입력 없이 값을 제공(공급)

3. 메서드 참조 (Method Reference)

4. Stream API와 람다

자주 사용되는 패턴

5. 클로저와 변수 캡처

6. 함수 조합 (Function Composition)

Function의 조합

Predicate의 조합

7. 실전 예제

7.1 리스트 필터링 및 변환

7.2 맵 순회 및 처리