Skip to main content
변경한 내용을 골라 스테이지하고, 메시지를 적어 커밋하는 가장 기본적인 작업 흐름입니다. ParalleLane은 파일·변경 덩어리(헝크)·논리적 한 줄 단위로 변경을 나눌 수 있어 커밋을 깔끔하게 구성할 수 있습니다.

워킹 카피 열기

커밋되지 않은 변경은 워킹 카피(Working copy) 패널에서 다룹니다. 여는 방법은 세 가지입니다.

그래프의 가상 행

변경사항이 있으면 커밋 그래프 맨 위에 “커밋되지 않은 변경(Uncommitted changes)” 행이 나타납니다. 이 행을 클릭하세요.

오른쪽 사이드바

오른쪽 사이드바의 워킹 카피 요약을 열면 됩니다. 변경이 없으면 “변경 없음”으로 표시됩니다.

단축키

워크트리를 선택한 상태에서 Cmd/Ctrl + Shift + C 로 워킹 카피로 전환합니다. 텍스트 입력란에 커서가 있을 때는 동작하지 않습니다.
패널은 변경 파일을 상태별 섹션으로 나눠 보여줍니다.
  • 충돌 파일(Conflicted) — 병합 중 충돌이 난 파일. 있을 때만 맨 위에 나타납니다.
  • 스테이지 안됨(Unstaged) — 아직 커밋 대상이 아닌 변경. Git이 추적하지 않는 새 파일도 이 섹션에 초록 + 배지로 함께 표시됩니다.
  • 스테이지됨(Staged) — 다음 커밋에 포함될 변경
스테이지 안됨 섹션 헤더 오른쪽에는 스테이지(Stage) 버튼, 스테이지됨 섹션 헤더 오른쪽에는 스테이지 해제(Unstage) 버튼이 있습니다. 이 버튼은 그 섹션에서 선택한 파일에 적용되며, 선택이 없으면 비활성화됩니다. 충돌 파일 섹션에는 이 버튼이 없습니다.
한 파일이 스테이지됨과 스테이지 안됨 양쪽에 동시에 나타날 수 있습니다. 파일 안의 일부만 스테이지한 경우입니다.
왼쪽에 커밋 그래프, 오른쪽에 워킹 카피 패널이 열린 화면. 워킹 카피에는 파일 8개가 있는 UNSTAGED 섹션과 2개가 있는 STAGED 섹션이 있고, UNSTAGED 안의 새 파일 notes/reconciliation-draft.md만 초록 + 배지로 구분된다

목록과 트리 보기

파일 목록 위의 보기 전환 버튼으로 상태별 파일을 두 방식으로 볼 수 있습니다.

목록 보기

전체 경로를 한 행에 표시합니다. 파일 수가 적거나 경로를 빠르게 검색할 때 편합니다.

트리 보기

폴더 계층으로 묶어 표시합니다. 폴더를 접고 펼칠 수 있고 / 키로 계층을 이동할 수 있습니다.
보기 방식과 접어 둔 폴더는 다시 열었을 때도 유지됩니다.

파일 단위로 스테이지하기

1

파일 확인

스테이지 안됨 섹션에서 커밋할 파일을 찾습니다. 파일을 클릭하면 가운데에 변경 내용(diff) 탭이 열립니다.
2

스테이지 / 스테이지 해제

파일을 선택한 뒤 섹션 헤더의 스테이지(Stage) 버튼으로 커밋 대상에 넣고, 스테이지됨 섹션에서는 스테이지 해제(Unstage) 버튼으로 다시 빼냅니다. Shift 클릭이나 Cmd/Ctrl 클릭으로 여러 파일을 선택하면 선택 전체에 한 번에 적용됩니다. 파일 행에 마우스를 올렸을 때 나타나는 × 버튼은 스테이지가 아니라 변경 버리기(Discard)입니다.
3

즉시 반영

스테이지/해제 결과는 화면에 곧바로 반영됩니다. 파일이 섹션 사이를 즉시 이동합니다.
버튼을 누르면 UI가 낙관적으로(optimistic) 먼저 갱신되고, 실제 Git 상태를 다시 읽어 확정합니다. 그래서 큰 리포지토리에서도 반응이 빠릅니다.

키보드로 스테이지하기

워킹 카피 패널에 포커스가 있을 때는 마우스 없이도 처리할 수 있습니다. 스테이지는 스테이지 안됨 섹션, 스테이지 해제는 스테이지됨 섹션에서 파일이 선택돼 있을 때만 동작합니다. 폴더만 선택했거나 충돌 섹션을 선택했을 때, 그리고 커밋 메시지 입력란에 커서가 있을 때는 실행되지 않습니다(Cmd/Ctrl + Enter 커밋만 입력 중에도 동작합니다).
표의 값은 기본값입니다. 설정 → ParalleLane → 단축키(Shortcuts) 에서 다른 키로 바꿀 수 있고, 이미 쓰이는 키나 시스템이 예약한 키를 고르면 그 자리에서 알려줍니다. 이 단축키들은 단축키 목록에서 “워킹카피” 카테고리(앱 표기 그대로)에 모여 있습니다. 자세한 내용은 단축키 & 탐색 문서를 참고하세요.

헝크·라인 단위로 스테이지하기

파일 전체가 아니라 변경 덩어리 또는 논리적 한 줄만 골라 스테이지할 수 있습니다. 파일을 클릭해 워킹 카피 diff를 엽니다.
1

변경 구간 확인

연속된 변경 덩어리 하나가 한 섹션입니다. 섹션 액션 버튼은 평소에는 숨어 있고, 그 섹션의 아무 행에 마우스를 올리거나 버튼이 키보드 포커스를 받으면 섹션 첫 행 오른쪽에 나타납니다. 통합 보기와 분할 보기 모두 동일하며, 분할 보기에서는 좌우 어느 쪽에 마우스를 올려도 나타나되 버튼 자체는 항상 오른쪽(현재) 패널에 표시됩니다.
2

헝크 Stage / Unstage

스테이지 안됨 diff에서는 Stage, 스테이지됨 diff에서는 Unstage를 누릅니다. 스테이지하지 않은 헝크에는 Discard도 표시됩니다. 파일 목록의 섹션 헤더 버튼은 한국어(스테이지 / 스테이지 해제)지만, 헝크 버튼은 한국어 UI에서도 Stage · Unstage · Discard 영문으로 표시됩니다.
3

한 줄만 적용 (선택)

지원되는 변경 줄에 마우스를 올리면 줄번호 옆 여백에 작은 아이콘 버튼이 나타납니다. 툴팁은 스테이지 안됨 diff에서 줄 스테이지(Stage line), 스테이지됨 diff에서 줄 언스테이지(Unstage line) 입니다. -old+new가 한 수정으로 짝지어진 경우에는 두 행이 하나의 논리적 변경으로 함께 적용됩니다.
아래 두 캡처는 마우스를 올리지 않은 상태여서 섹션·라인 액션 버튼이 모두 숨어 있습니다. 헝크 위에 마우스를 올리면 섹션 버튼은 첫 행 오른쪽에, 라인 버튼은 그 행의 줄번호 옆에 나타납니다.
스테이지하지 않은 워킹 카피 diff. 워크플로 YAML의 한 헝크에서 runs-on 한 줄이 빨강(−)으로 지워지고 strategy·matrix·target·runs-on 네 줄이 초록(+)으로 추가됐다
이미 스테이지한 워킹 카피 diff. Rust 파일의 기존 함수 아래에 상수 선언 두 줄이 초록(+)으로 추가된 작은 헝크가 보인다
라인 액션은 HEAD·index·작업 트리에 모두 존재하는 수정된 텍스트 파일의 워킹 카피 diff에서만 제공됩니다. 새 파일, 삭제·이름 변경, 충돌, 바이너리·LFS 파일에서는 라인 액션이 나타나지 않습니다. 공백 변경 무시를 켜면 라인 액션과 헝크 액션이 함께 사라지므로(표시된 diff와 실제 패치의 헝크 번호가 어긋날 수 있어서) 파일 단위로 처리하세요. 라인 단위 Discard는 제공하지 않습니다.

커밋하기

워킹 카피 패널 상단의 커밋 폼. Summary (required) 입력란, Description 입력란, Amend last commit 체크박스, 초록 Commit 버튼이 차례로 놓여 있다
1

커밋 메시지 작성

패널 상단의 요약(Summary) 입력란은 필수입니다. 필요하면 아래 설명(Description) 에 자세한 내용을 적습니다. 요약과 설명은 한 줄 띄워 하나의 메시지로 합쳐집니다.
2

Commit 클릭

커밋(Commit) 버튼을 누르거나 Cmd/Ctrl + Enter를 입력합니다. 스테이지된 항목이 없거나 요약이 비어 있으면 실행되지 않습니다.
3

결과 확인

커밋이 성공하면 그래프가 새로 그려지고 새 커밋이 선택됩니다. 워킹 카피가 깨끗해지면 “커밋되지 않은 변경” 행은 자동으로 사라집니다.
커밋에는 스테이지된 변경만 포함됩니다. 스테이지 안 한 변경은 그대로 남습니다. pre-commit 같은 Git hook이 설정돼 있으면 커밋 시 자동 실행되며, hook이 거부하면 커밋이 실패합니다.