GitLinq / GETTING STARTED
처음이라도,
하나씩 따라오세요.
무엇을 누를지, 어떤 화면이 나올지, 그다음에는 무엇을 할지. Git이 낯설어도 사용할 수 있도록 순서대로 안내합니다.
1단계: 실행 준비부터 시작 →SVN에는 익숙한데,
Git은 헷갈리나요?
GitLinq는 SVN을 쓰다가 Git으로 옮겨 온 분, 그리고 예전에 반영한 내 변경 하나만 취소하고 싶은 분을 위해 만들고 있습니다. 긴 해시값을 외우기보다 작성자와 설명으로 변경을 찾고, 취소 결과를 먼저 읽는 경험을 목표로 합니다.
만들게 된 배경과 앞으로의 방향은 GitLinq를 만든 이유에서 읽을 수 있습니다. 아래 Git 기초는 선택 사항입니다. 궁금한 항목만 열어 보세요.
① 내 PC에 이미 준비된 Git 프로젝트 폴더가 있어야 합니다. 서버 주소만 있다면 팀 담당자에게 처음 내려받는 방법을 확인하세요.
② 현재 0.2.2는 로그 확인 · 서버 변경 받기 · 내 변경 취소를 지원합니다. 새 작업을 올리는 일상 커밋, 처음 내려받기(복제), 충돌 내용을 직접 편집하는 기능은 아직 없습니다.
GitLinq 실행 준비
① 위쪽 설정 → Git 경로에서 Git을 확인합니다.
② 프로젝트를 열 때는 아래 버튼을 사용합니다.
먼저 확인할 것
Windows 10 또는 11의 x64 PC가 필요합니다. 화면을 표시하는 Microsoft Edge WebView2 Evergreen Runtime도 설치되어 있어야 합니다. Git은 지금 없어도 GitLinq를 연 뒤 설정에서 준비할 수 있습니다.
WebView2가 없다면 Microsoft 공식 WebView2 다운로드에서 Evergreen Standalone Installer의 x64를 준비하세요. 회사 PC에서 프로그램 설치가 제한되어 있다면 담당자가 승인한 설치 방법을 사용하세요.
설치해서 쓰기
어디를 누르나요? GitLinq 공개 배포 페이지를 엽니다. 배포 파일 목록인 Assets에서 GitLinq-0.2.2-windows-x64-setup.exe를 받아 실행합니다. 설치를 마치면 Windows 시작 메뉴에서 GitLinq를 엽니다.
무엇이 보이나요? 앱 위쪽에 파일 · 저장소 · 보기 · 설정 · 도움말 메뉴가 보입니다. 아직 저장소를 열지 않았다면 저장소 폴더 선택 버튼이 있습니다.
다음에는요? 아래의 Git 준비로 이동하세요. 설치 프로그램은 Git을 대신 설치하거나 PC의 Git 경로를 바꾸지 않습니다.
WebView2가 없다는 안내로 설치가 멈추면 WebView2를 준비한 뒤 설치 파일을 다시 실행하세요. 이 배포본은 서명되지 않은 공개 미리보기여서 Windows에 게시자를 확인할 수 없다는 안내가 나올 수 있습니다. 위 공식 배포 페이지나 회사 배포 담당자가 제공한 파일인지 확인하세요.
설치 없이 쓰기
어디를 누르나요? 같은 배포 페이지에서 GitLinq-0.2.2-windows-x64-portable.zip을 받습니다. 다음 순서로 실행하세요.
- Windows 파일 탐색기의 다운로드 폴더에서 받은 ZIP을 찾습니다. 못 찾겠다면 다운로드한 웹브라우저에서 Ctrl+J를 눌러 다운로드 목록을 확인하세요.
- ZIP 파일을 마우스 오른쪽 버튼으로 누르고 모두 압축 풀기…를 선택합니다.
- 압축을 풀 위치를 확인하고 압축 풀기를 누릅니다. 내가 파일을 저장할 수 있는 폴더를 사용하세요.
- 압축을 푼 폴더를 열고 GitLinq.exe를 더블클릭합니다. ZIP 파일 내부가 아니라 새로 풀린 폴더인지 확인하세요.
무엇이 보이나요? 설치본과 같은 GitLinq 화면이 열립니다. Windows 앱 목록의 설치 등록이나 시작 메뉴 바로가기는 만들지 않습니다.
다음에는요? 아래의 Git 준비를 진행하세요. 무설치본도 WebView2가 필요합니다. 압축 파일 안에서 실행하거나 실행 파일 하나만 꺼내 쓰지 말고, 압축을 푼 폴더의 파일들을 함께 두세요.
설치본과 무설치본은 같은 Windows 사용자 계정의 설정과 저장된 취소 작업을 함께 사용합니다. 무설치본 폴더를 다른 PC로 옮긴다고 설정까지 같이 옮겨지는 것은 아닙니다.
Git 준비
Git은 저장소를 읽고 변경을 처리하는 데 필요한 프로그램입니다. GitLinq가 그 프로그램을 사용해 화면의 작업을 수행합니다.
A. 이미 Git이 있는 경우
어디를 누르나요? 상단 설정을 누르고 Git 경로를 선택합니다. 기본 선택은 자동 인식입니다. 경로 확인을 눌러 현재 사용할 Git을 확인할 수도 있습니다.
무엇이 보이나요? 사용할 수 있는 Git을 찾으면 Git [버전] 확인됨과 경로가 표시됩니다. Git 2.30 이상이 필요합니다.
다음에는요? 자동 인식 상태로 이미 확인되었다면 설정을 닫고 저장소를 열면 됩니다. 경로를 바꾸고 저장했다면 GitLinq를 닫았다가 다시 실행하세요.
B. Git이 없거나 찾지 못한 경우
어디를 누르나요? 설정 → Git 준비·업데이트를 엽니다. Git 경로 화면에서 Git을 사용할 수 없습니다가 보인다면 Git 다운로드·오프라인 가져오기를 눌러도 같은 준비 화면으로 이동합니다. 여기서 다운로드 후 사용을 누릅니다.
무엇이 보이나요? Git을 내려받아 준비하고 있습니다…라는 안내 뒤에, 성공하면 Git 준비 완료와 준비된 경로가 표시됩니다. 다운로드와 파일 검증에는 시간이 조금 걸릴 수 있습니다.
다음에는요? GitLinq를 닫고 다시 실행하세요. 새 Git은 다음 실행부터 사용합니다. 다시 설정 → Git 경로를 열어 Git [버전] 확인됨이 보이는지 확인한 뒤 저장소를 여세요.
0.2.2가 준비하는 패키지는 공식 MinGit 2.55.0.5 x64입니다. 앱 전용 폴더에 새 버전으로 보관하고, 기존에 설치한 Git은 덮어쓰지 않습니다. 준비 도중 멈추려면 화면에 보이는 준비 중단을 누르고 결과 안내를 기다리세요.
C. 회사에서 제공한 Git을 사용하는 경우
어디를 누르나요? 설정 → Git 경로 → 직접 지정 → 찾아보기…를 누릅니다. 회사에서 제공한 Git 폴더의 cmd\git.exe를 선택합니다.
무엇이 보이나요? 선택한 경로가 Git 실행 파일 칸에 표시됩니다. 경로 확인을 누르면 이 Git을 사용할 수 있는지 확인합니다.
다음에는요? 사용할 수 있다고 나오면 저장을 누릅니다. 저장 완료 안내를 확인하고 GitLinq를 닫았다가 다시 실행하세요. 경로 확인은 점검이고, 저장이 사용할 경로를 보관하는 동작입니다.
git.exe 하나만 복사해서는 사용할 수 없습니다. Git 폴더 전체가 필요합니다. 잘못된 경로는 저장하지 않으므로 저장하지 않았습니다가 보이면 위치를 다시 선택하세요.
D. 회사에서 외부 다운로드를 막은 경우
회사 배포 담당자에게 공식 MinGit-2.55.0.5-64-bit.zip 파일을 요청하세요. 이 ZIP은 압축을 풀지 않고 설정 → Git 준비·업데이트 → ZIP 가져오기…에서 선택합니다. Git 준비 완료 뒤 앱을 다시 실행합니다. 다른 버전의 ZIP이나 다시 압축한 파일은 사용할 수 없습니다.
이름이 비슷해도 두 ZIP의 사용법이 다릅니다. GitLinq 무설치 ZIP은 모두 풀어 실행하고, MinGit ZIP은 원본 그대로 앱에서 가져옵니다.
회사에서 프록시나 사내 ZIP 주소를 제공했다면 설정 → 연결 설정에서 입력하고 연결 설정 저장을 누릅니다. 주소가 필요한지 모른다면 기본 자동을 그대로 사용하고 담당자에게 확인하세요. 계정이나 암호를 주소에 넣지 마세요.
이 연결 설정은 GitLinq 버전 확인과 Git 패키지 다운로드에 적용됩니다. 저장소 서버의 로그인이나 접근 권한은 해당 저장소의 Git 연결 설정을 사용하므로, 다운로드가 된다고 저장소 접속도 설정된 것은 아닙니다.
내 PC의 저장소 열기
여기서 저장소는 팀 프로젝트의 파일과 Git 변경 내역이 들어 있는 폴더를 말합니다.
어디를 누르나요? 첫 화면의 저장소 폴더 선택을 누릅니다. 이미 다른 저장소를 보고 있다면 위쪽 저장소 바꾸기, 또는 파일 → 저장소 열기…를 사용합니다. 폴더 선택 창에서 내 PC의 해당 Git 프로젝트 폴더를 선택하세요.
무엇이 보이나요? 위쪽에 저장소 이름과 현재 작업 중인 브랜치 이름이 보이고, 로그 목록에 작성자와 변경 설명이 나타납니다. 저장소를 열고 로그를 읽는 것만으로 내 PC의 작업 파일이나 서버가 바뀌지는 않습니다.
다음에는요? 이름이 맞는 저장소인지 확인하고 다음 절의 로그를 읽어 보세요.
서버 주소만 있고 내 PC에 Git 저장소가 아직 없다면, 먼저 팀 담당자에게 저장소를 내려받는 방법을 확인해야 합니다. 0.2.2에는 복제나 새 저장소 초기화 기능이 없습니다. SVN으로 받은 작업 폴더를 선택해도 Git 저장소로 자동 변환하지 않습니다. GitHub에서 일반 소스 ZIP을 받아 푼 폴더도 Git 변경 내역이 들어 있는 작업 폴더와 다릅니다.
선택할 곳은 프로젝트 파일이 들어 있는 Git 작업 폴더입니다. GitLinq 설치 폴더나 숨겨진 .git 폴더 자체를 고르는 것이 아닙니다. 어느 폴더인지 모르겠다면 “이 프로젝트의 Git 저장소 폴더가 어디인가요?”라고 확인하세요.
로그에서 누가 무엇을 바꿨는지 보기
어디를 누르나요? 목록의 작성자나 변경 설명이 있는 행을 누릅니다. 내 작업을 찾고 싶다면 목록 위의 내 변경만 보기에 체크하세요. 더 오래된 항목은 목록 아래 더 불러오기로 읽습니다.
무엇이 보이나요? 선택한 변경 아래에 변경 파일과 변경 전 / 변경 후가 표시됩니다. 아래 내용이 안 보이면 화면을 아래로 스크롤하세요. 삭제와 추가 표시로 어느 내용이 바뀌었는지 비교할 수 있습니다. 이는 선택한 커밋이 당시 바꾼 내용이며, 지금 내 PC의 전체 작업 상태를 보여 주는 화면은 아닙니다. 긴 변경은 일부만 표시했다는 안내가 함께 나올 수 있습니다.
다음에는요? 내용만 확인하려면 다른 행을 계속 선택하면 됩니다. 내 변경을 취소하려면 해당 행의 상세 내용을 읽고 취소 미리보기로 이동합니다. 동료의 서버 변경을 내 PC로 받고 싶은 경우에는 다음 절의 저장소 업데이트를 사용하세요.
로그에 보이는 안내 이해하기
표가 잘리면 좌우로 밀어 읽으세요.
| 화면의 표시 | 뜻과 다음 행동 |
|---|---|
| 나 / 내 변경 | 현재 저장소의 Git 사용자 이메일과 작성자 이메일이 맞는 변경입니다. Windows 로그인 이름을 기준으로 하는 표시는 아닙니다. |
| 서버 상태 미확인 | 내 PC의 로그를 읽었지만 현재 서버와 아직 대조하지 않았다는 뜻입니다. 변경이 서버에 없다는 뜻이나 오류가 아닙니다. |
| 로그 새로고침 | 내 PC의 로그를 다시 읽습니다. 서버의 새 파일을 받아 오는 버튼은 아닙니다. |
| 불러온 로그에 내 변경이 없습니다. | 현재 불러온 범위에서 내 이메일과 맞는 변경을 찾지 못했습니다. 필터를 해제하거나 더 불러오기를 사용하세요. 이전에 다른 이메일로 작성했다면 ‘내 변경’으로 잡히지 않을 수 있습니다. |
| 첫 커밋 / 병합 커밋 / 다른 작성자 | 내용을 열어 볼 수 있습니다. 이 버전에서는 취소 미리보기의 시작 대상으로 선택할 수 없습니다. |
로그는 현재 브랜치의 주요 흐름을 보여 줍니다. 병합된 다른 분기의 개별 커밋까지 모두 펼쳐 보이는 목록은 아닙니다. 어떤 변경을 찾지 못했다고 해서 그 변경이 삭제되었다고 판단하지 마세요.
서버 변경을 내 PC로 받기
동료가 서버에 반영한 작업이나, GitLinq로 서버에서 취소한 결과를 내 작업 폴더에 받는 기능입니다. 이 작업은 내 PC 파일을 바꿉니다. 서버에 새 변경을 올리는 동작은 아닙니다.
5-1. 받을 대상을 확인합니다
어디를 누르나요? 저장소를 연 상태에서 저장소 → 업데이트…를 누릅니다.
무엇이 보이나요? 서버 변경을 내 PC로 받습니다 화면에 선택한 저장소, 연결할 서버, 공유 위치가 보입니다.
다음에는요? 팀에서 사용하는 위치가 맞는지 확인하고 받을 변경 확인을 누릅니다. 모르는 위치라면 적용하지 말고 저장소 담당자에게 확인하세요. 이 확인 단계에서는 내 PC 작업 파일을 바꾸지 않습니다.
5-2. 받을 내용을 읽고 적용합니다
어디를 누르나요? 내 PC에 적용할 서버 변경입니다가 나오면 받을 커밋의 작성자와 설명, 변경될 파일 수를 읽습니다. 받을 내용이 맞으면 내 PC 업데이트를 누릅니다.
무엇이 보이나요? 파일을 적용하는 동안 진행 안내가 나타납니다. 내 PC 업데이트 완료가 표시되면 완료된 것입니다. 받을 변경이 없습니다가 나왔다면 지금 받을 새 변경이 없는 상태입니다.
다음에는요? 로그로 돌아가기로 돌아가 작업 내용을 확인하세요. 적용 중에는 같은 저장소에서 다른 Git 작업이나 파일 수정을 진행하지 마세요.
업데이트가 멈췄다면
지금은 업데이트할 수 없습니다는 현재 상태에서 자동으로 받을 수 없다는 뜻입니다. 수정 중인 파일이나 새로 만든 파일, 내 PC와 서버에서 각각 진행된 변경, 다른 Git 작업, 아직 지원하지 않는 저장소 설정 등이 원인일 수 있습니다.
작업 파일을 지우거나 내 변경을 버려서 통과시키지 마세요. 화면 안내를 읽고, 평소 사용하는 Git 도구나 저장소 담당자의 도움으로 내 작업을 먼저 보관하고 상태를 정리하세요. GitLinq 0.2.2는 충돌 내용을 직접 편집하거나 갈라진 변경을 자동으로 합치지 않습니다.
업데이트 결과를 확인해야 합니다라면 결과만 다시 확인을 누르세요. 앱을 다시 열었다면 같은 저장소에서 저장소 → 업데이트… → 중단한 업데이트 결과 확인으로 확인합니다. 이 동작은 결과만 확인하며 파일 적용을 새로 시작하지 않습니다.
확인할 미완료 업데이트가 없습니다는 확인할 중단 작업이 없다는 뜻입니다. 서버의 최신 변경을 모두 받았다는 뜻은 아닙니다. 새로 받을 내용을 알고 싶다면 업데이트 화면에서 받을 변경 확인을 진행하세요.
중간에 반영한 내 변경 하나 취소하기
예를 들어 내가 ‘로그인 안내 문구 수정’을 서버에 반영한 뒤, 동료가 ‘알림 설정 추가’를 반영했다고 해 볼게요. 로그인 문구만 이전 내용으로 돌리고 싶을 수 있습니다. GitLinq는 선택한 내 변경을 뺐을 때의 결과와, 이후 변경이 유지되는지를 먼저 보여 줍니다.
현재 대상은 서버에 반영된 내 일반 커밋 한 개입니다. 그 뒤의 변경이 선택한 변경에 의존하거나 같은 부분을 수정했다면 자동 취소가 어려울 수 있습니다.
6-1. 취소할 내 변경을 고릅니다
어디를 누르나요? 로그에서 작성자와 설명을 보고 대상 행을 선택합니다. 아래 상세 내용이 내가 취소하려는 변경인지 읽은 뒤 취소 미리보기를 누릅니다.
무엇이 보이나요? 이 변경만 빼면 어떻게 될까요? 화면에 선택한 내 변경과 작성자, 설명이 나타납니다.
다음에는요? 대상이 맞는지 한 번 더 보고 서버 확인으로 진행합니다. 취소 미리보기가 없다면 상세 내용 읽기가 끝났는지, 다른 작성자·첫 커밋·병합 커밋인지 확인하세요. 화면에서 읽는 기능과 취소 대상으로 선택하는 기능은 지원 범위가 다릅니다.
6-2. 현재 서버 내용을 확인합니다
어디를 누르나요? 이 서버의 현재 내용을 확인합니다에서 서버와 공유 위치를 읽고 서버 확인 후 미리보기를 누릅니다. 대상이 여러 개라면 확인할 서버에서 팀의 공유 위치를 선택합니다.
무엇이 보이나요? 현재 서버에서 선택한 변경을 찾고 취소 결과를 계산합니다. 아직 서버에 취소 커밋을 보내거나 내 PC 작업 파일을 바꾸는 단계가 아닙니다.
다음에는요? 결과 화면이 나타날 때까지 기다린 뒤 다음 세 가지를 확인하세요.
- 취소 전 / 취소 후: 실제로 되돌릴 내용이 맞나요?
- 취소로 달라지는 파일: 예상하지 못한 파일이 포함되어 있지는 않나요?
- 유지되는 후속 변경: 남겨 두려는 이후 작업이 어떻게 판정되었나요?
미리보기는 변경 위치와 범위를 확인한 결과입니다. 프로그램의 기능까지 모두 정상 작동함을 보장하지는 않습니다. 내용이 길어 일부만 표시했다는 안내가 있으면 화면에 보이는 목록이 전부라고 생각하지 마세요.
6-3. 결과에 따라 다음 행동을 고릅니다
표가 잘리면 좌우로 밀어 읽으세요.
| 보이는 제목 | 다음 행동 |
|---|---|
| 선택한 변경을 뺀 결과입니다 | 결과가 의도와 맞으면 취소 커밋 준비를 누릅니다. 아직 최종 서버 반영 전입니다. |
| 자동 취소 결과를 확정할 수 없습니다 | 선택한 변경의 원래 내용과 함께 확인할 후속 변경을 읽으세요. 이 화면의 차이는 확정된 취소 결과가 아닙니다. 직접 충돌 해결은 아직 지원하지 않으므로 담당자와 내용을 확인합니다. |
| 이 변경은 자동 취소를 지원하지 않습니다 | 화면의 사유를 읽고 로그로 돌아갑니다. 다른 도구나 담당자의 도움이 필요합니다. |
| 현재 서버에 취소할 내용이 없습니다 | 서버에 새 취소 커밋을 보내지 않습니다. 현재 서버 상태와 선택한 변경을 확인하고 로그로 돌아갑니다. |
| 분석하는 동안 서버 내용이 바뀌었습니다 | 이전 결과로 진행하지 말고 서버 상태 다시 확인으로 새 내용을 확인하세요. |
| 선택한 변경을 서버의 현재 이력에서 찾지 못했습니다 | 아직 서버에 반영하지 않은 변경이거나 다른 공유 위치일 수 있습니다. 서버와 대상을 확인하세요. |
예를 들어 내가 파일을 추가했고 그 뒤의 커밋이 그 파일을 수정했다면, 파일 추가를 취소하면서 동료의 수정을 그대로 남기기 어려울 수 있습니다. 이 경우 자동 취소 결과를 확정할 수 없습니다로 관련 내용을 보여 주며 자동으로 취소하지 않습니다.
6-4. 서버에 반영할 내용을 최종 확인합니다
어디를 누르나요? 취소 커밋 준비 뒤의 이 내용으로 서버에 취소 커밋합니다 화면을 읽습니다. 취소할 내 변경, 달라지는 파일, 유지되는 후속 변경과 저장소 · 서버 · 공유 위치를 확인하세요.
무엇이 보이나요? 최종 확인 체크박스 취소 결과와 서버 위치를 확인했습니다와 서버에 취소 커밋 버튼이 있습니다. 내용이 길면 아래로 스크롤해 끝까지 읽으세요.
다음에는요? 내용이 맞을 때 체크박스를 선택하고 서버에 취소 커밋을 누릅니다. 이 버튼부터 서버 반영을 시작합니다. 그 전의 미리보기와 준비 화면에서 돌아가는 것은 서버에 취소 결과를 보내는 동작이 아닙니다.
이 작업은 과거 커밋을 삭제하지 않습니다. 선택한 변경을 되돌리는 새 취소 커밋을 서버에 추가합니다. 서버 내용이 확인한 때와 달라졌다면 멈추고 다시 확인하도록 안내합니다.
6-5. 완료 문구를 확인합니다
어디를 보나요? 처리 결과의 제목을 확인하세요.
무엇이 보이나요? 선택한 변경을 서버에서 취소했습니다가 표시되면 서버 반영을 확인한 상태입니다. 내 PC 파일은 아직 바뀌지 않았습니다.라는 안내도 함께 나타납니다.
다음에는요? 서버에 반영된 취소 결과를 내 PC에도 받으려면 로그로 돌아가기 → 저장소 → 업데이트…를 사용합니다. 내 PC에 수정 중인 파일이 있으면 업데이트가 멈출 수 있으므로 앞의 업데이트 안내를 따라 주세요.
서버에 반영된 취소 결과를 내 PC에도 적용하려면, 별도로 저장소 업데이트를 합니다.
팀 서버에 취소 결과를 추가합니다.
내 PC 작업 파일은 아직 그대로받을 변경을 확인한 뒤 내 파일에 적용합니다.
수정 중인 작업이 있으면 먼저 안내 확인멈춘 작업과 결과 확인
취소 버튼을 누른 뒤 연결이 끊겼어요
서버 반영 여부를 확인해야 합니다가 보이면 실패로 단정하지 마세요. 서버에는 반영되었지만 완료 응답을 받지 못한 경우도 있습니다.
어디를 누르나요? 서버 반영 여부 확인을 누릅니다. 연결 확인 화면이 나오면 서버와 공유 위치를 확인하고 서버 연결 확인을 누르세요.
무엇이 보이나요? 저장된 같은 취소 작업이 서버에 반영되었는지 확인한 결과가 표시됩니다. 이 확인 버튼은 취소 커밋을 다시 보내지 않습니다.
다음에는요? 아래 결과에 따라 진행하세요. 결과를 알기 전에 같은 변경으로 새 취소 작업을 시작하지 마세요.
표가 잘리면 좌우로 밀어 읽으세요.
| 결과 | 다음 행동 |
|---|---|
| 선택한 변경을 서버에서 취소했습니다 | 서버 반영 완료입니다. 필요하면 별도로 내 PC 업데이트를 합니다. |
| 서버에 반영되지 않았음을 확인했습니다 | 같은 취소 결과 다시 보내기가 표시된 경우에만 그 버튼으로 보관된 결과를 다시 보낼 수 있습니다. 앱이 현재 서버 상태를 다시 확인합니다. |
| 서버 내용이 바뀌어 다시 확인해야 합니다 | 기존 결과를 다시 보내지 말고 로그에서 새 취소 미리보기를 시작합니다. |
| 계속 서버 반영 여부를 확인해야 합니다 | 연결과 권한을 확인한 뒤 같은 저장된 작업에서 결과를 다시 확인합니다. 아직 완료로 볼 수 없습니다. |
| 취소 커밋을 완료하지 못했습니다 | 화면 안내와 서버 연결 상태를 확인하세요. 재전송 버튼이 없으면 임의로 같은 결과를 보낼 수 없습니다. |
앱을 닫았거나 PC를 다시 시작했어요
어디를 누르나요? GitLinq를 다시 열고 보기 → 취소 작업과 결과를 누릅니다. 로그 위쪽에 확인할 작업 [숫자]건, 작업 상태 확인, 취소 작업 버튼이 보이는 경우 그 버튼으로 들어가도 됩니다.
무엇이 보이나요? 저장된 취소 작업 목록에 저장소와 공유 위치, 상태가 표시됩니다.
다음에는요? 진행하던 작업을 선택해 결과부터 확인하세요. 목록을 읽지 못했다면 다시 불러오기 또는 화면의 재확인 버튼을 사용합니다. 이전에 무엇이 반영되었는지 확인한 뒤 새 작업을 시작하세요.
확인하지 못한 작업이 남아 있다면 저장소 폴더의 이름이나 위치를 바꾸거나, 저장된 취소 작업 데이터를 지우지 말고 먼저 결과를 확인하세요.
자주 막히는 상황
표가 잘리면 좌우로 밀어 읽으세요.
| 상황 | 먼저 할 일 |
|---|---|
| 저장소를 열지 못해요 | 설정 → Git 경로에서 Git이 확인되는지, 선택한 폴더가 기존 Git 저장소인지 확인합니다. 경로를 바꾸었다면 재시작해야 합니다. |
| 내 변경인데 ‘나’로 안 보여요 | 현재 저장소의 Git 사용자 이메일과 당시 작성자 이메일이 다를 수 있습니다. 필터를 해제해 내용을 찾고, 이메일 설정은 담당자에게 확인합니다. |
| 로그에 동료의 최신 변경이 안 보여요 | 로그 새로고침은 로컬 로그만 읽습니다. 서버의 변경을 받으려면 저장소 → 업데이트…로 확인합니다. |
| 미리보기를 완료하지 못했습니다 | 화면의 사유와 연결 대상을 확인하고 다시 확인을 누릅니다. 반복되면 버전과 화면 문구를 담당자에게 전달합니다. |
| 서버 위치가 맞는지 모르겠어요 | 표시된 서버와 공유 위치를 팀 담당자에게 확인하고 진행합니다. |
| 업데이트를 받을 서버 위치가 지정되어 있지 않습니다 | 저장소 담당자에게 현재 브랜치의 서버 연결 설정을 확인해 달라고 요청합니다. |
| Git 다운로드나 새 버전 확인만 안 돼요 | 설정 → 연결 설정에서 회사 환경을 확인하거나 오프라인 Git ZIP을 사용합니다. 저장소 인증 설정과는 별개입니다. |
도움을 요청할 때는 GitLinq 버전, 누른 버튼, 멈춘 단계, 화면에 나온 문구를 알려 주세요. 원본 코드나 인증 정보는 필요하지 않습니다. 화면을 공유한다면 개인 정보나 비공개 저장소 정보가 들어 있는지 먼저 확인하세요.
GitLinq와 Git 업데이트
이름이 비슷하지만 다음 네 가지는 서로 다른 작업입니다.
표가 잘리면 좌우로 밀어 읽으세요.
| 하고 싶은 일 | 메뉴 또는 버튼 | 무엇이 바뀌나요? |
|---|---|---|
| 내 PC의 목록을 다시 읽기 | 로그 새로고침 | 로그 표시를 다시 읽습니다. 서버 변경을 받지 않습니다. |
| 팀 서버의 변경 받기 | 저장소 → 업데이트… | 확인 후 내 PC 업데이트를 누르면 작업 파일이 바뀝니다. |
| GitLinq 앱의 새 버전 확인 | 도움말 → GitLinq 업데이트 확인… | 공개 배포 버전을 조회합니다. 앱을 자동 교체하지 않습니다. |
| Git 실행 프로그램 준비 | 설정 → Git 준비·업데이트 | 지원 Git 패키지를 준비하고 다음 실행에 사용할 경로를 저장합니다. |
GitLinq의 새 버전 확인하기
어디를 누르나요? 도움말 → GitLinq 업데이트 확인… → 지금 확인을 누릅니다.
무엇이 보이나요? 현재 버전과 공개 배포의 확인 결과가 보입니다. 새 버전이 있으면 새 버전 [버전], 조회를 마쳤다면 버전 확인 완료, 조회하지 못했다면 확인할 수 없습니다와 사유가 표시됩니다.
다음에는요? 새 버전을 받으려면 배포 페이지 주소 복사를 누르고 브라우저 주소창에 붙여 넣어 배포 페이지를 엽니다. 공개 배포 페이지는 GitHub 로그인 없이 볼 수 있습니다. 회사가 별도로 배포하는 환경이라면 담당자가 제공한 파일을 사용하세요.
앱은 지금 확인을 누를 때 공개 GitHub에 연결하며 자동 다운로드나 파일 교체는 하지 않습니다. 확인할 수 없습니다를 최신 버전이라는 뜻으로 받아들이지 마세요.
새 파일로 교체하기
- 설치본: GitLinq를 닫고 새 버전의 설치 파일을 실행합니다.
- 무설치본: GitLinq를 닫고 새 ZIP을 별도 폴더에 모두 푼 뒤 새 폴더의
GitLinq.exe를 실행합니다. 직접 만든 바탕화면 바로가기가 있다면 새 폴더의 실행 파일을 가리키는지도 확인하세요.
같은 Windows 사용자 계정에서는 설정과 저장된 취소 작업을 이어서 읽습니다. 반영 여부가 미확인인 취소 작업이 있었다면 새 앱에서도 먼저 그 결과를 확인하세요.
Git 버전 확인하기
어디를 누르나요? 설정 → Git 준비·업데이트 → 버전 확인을 누릅니다.
무엇이 보이나요? 선택된 Git과 GitLinq 지원 패키지를 비교해 보여 줍니다. 0.2.2에 포함된 지원 정보는 MinGit 2.55.0.5입니다.
다음에는요? 준비가 필요한 경우 안내에 따라 다운로드 후 사용 또는 ZIP 가져오기…를 사용하고 앱을 다시 실행합니다. 버전 확인은 이 배포본에서 확인한 지원 버전과 비교하는 기능이며, 인터넷에서 Git의 최신 버전을 찾아 자동으로 교체하는 기능은 아닙니다.
같은 버전이나 더 새로운 Git이 이미 선택되어 있다면 다운로드·가져오기 버튼이 비활성화될 수 있습니다. 이때는 선택된 Git 버전과 안내 문구를 읽으세요.
앱 제거와 남아 있는 데이터
설치본은 GitLinq를 닫고 Windows 설정의 앱 목록에서 GitLinq를 제거합니다. 무설치본은 앱을 닫은 상태에서 압축을 풀었던 앱 폴더를 정리할 수 있습니다.
설정과 저장된 취소 작업은 %APPDATA%\GitLinq에 따로 보관됩니다. 앱을 제거해도 저장소와 사용자 작업 파일, 저장된 작업 데이터, 준비한 Git과 WebView2는 그대로 남습니다. 같은 계정으로 다시 실행하거나 설치하면 보관된 취소 작업의 결과를 이어서 확인할 수 있습니다.
궁금할 때만 읽는 Git 기초
이 내용을 전부 배운 뒤 시작할 필요는 없습니다. 사용하다 궁금해진 질문만 눌러 펼쳐 보세요.
SVN 커밋과 Git 커밋은 무엇이 다른가요?
SVN에서는 보통 커밋 한 번으로 서버에 변경을 보냅니다. Git에서는 먼저 내 PC에 변경 묶음을 남기는 커밋, 그 커밋을 서버에 보내는 푸시가 나뉘어 있습니다.
SVN의 일반적인 흐름
내 작업 파일 → 커밋 → 팀 서버
Git의 일반적인 흐름
내 작업 파일 → 로컬 커밋 → 푸시 → 팀 서버
그래서 Git에서 “커밋했어요”만으로는 동료가 서버에서 받을 수 있는 상태인지 알 수 없습니다. 서버로 보내는 단계도 완료되어야 합니다.
GitLinq가 지향하는 일상 커밋은 이 두 단계를 내부에서 처리하고, 사용자는 서버에 반영된 결과를 확인하는 방식입니다. 이 일상 커밋 기능은 0.2.2에 아직 없습니다. 현재의 서버에 취소 커밋은 선택한 과거 변경을 되돌리는 전용 작업입니다. 새로 수정한 내 작업 파일을 서버에 올리는 버튼으로 사용하지 마세요.
Git의 일반적인 흐름을 설명하는 예시입니다. 이 버튼은 실제 파일이나 서버를 바꾸지 않습니다.
파일을 수정했지만 아직 커밋하지 않았습니다. 서버와 동료의 PC에는 이전 내용이 있습니다.
내 파일, 로컬 커밋, 서버의 변경은 어떻게 다른가요?
표가 잘리면 좌우로 밀어 읽으세요.
| 위치 | 뜻 | 예시 |
|---|---|---|
| 내 작업 폴더 | 지금 편집기에서 보고 수정하는 파일 | 아직 커밋하지 않은 문구 수정 |
| 내 PC의 Git 로그 | 내 PC에 저장된 커밋 목록 | 로컬에만 있는 커밋, 이전에 서버에서 받은 커밋 |
| 팀 서버 | 동료들과 공유하는 커밋이 있는 곳 | 동료가 새로 보낸 변경, GitLinq가 반영한 취소 커밋 |
이 세 곳의 상태는 항상 같지 않습니다. 서버에서 취소해도 내 작업 폴더가 저절로 바뀌지는 않고, 저장소 업데이트로 서버 변경을 받아야 합니다. 반대로 내 PC에서 파일을 고쳤다고 곧바로 서버가 바뀌지도 않습니다.
커밋과 로그는 무엇인가요?
커밋은 “어떤 내용을 바꾸었는지”를 저장한 변경 묶음 하나입니다. 작성자와 설명이 붙어 있고, 로그에서는 그 묶음들을 순서대로 볼 수 있습니다.
Git은 각 커밋에 긴 영문·숫자 식별자인 해시를 붙입니다. 정확히 같은 커밋을 구별할 때 쓰지만, 처음 사용할 때 외울 필요는 없습니다. GitLinq에서는 작성자와 설명을 먼저 보고 내용을 확인하면 됩니다.
첫 커밋은 그 흐름의 시작이고, 병합 커밋은 나뉘어 진행한 작업 흐름을 합친 커밋입니다. 0.2.2에서는 이 두 종류의 내용을 읽을 수 있지만 취소 대상으로 고르지는 못합니다.
작성자와 서버에 보낸 사람은 같나요?
로그의 작성자는 해당 변경에 저장된 작성자 정보입니다. 그 커밋을 나중에 서버에 전송한 사람과 항상 같지는 않습니다. 예를 들어 내가 작성한 커밋을 다른 사람이 함께 서버에 보낼 수도 있습니다.
따라서 GitLinq의 나는 “이 변경의 작성자 이메일이 현재 저장소의 내 이메일과 같다”는 뜻입니다. “실제로 내가 푸시했다”는 증명은 아닙니다. 0.2.2 로그에서 실제 전송한 사람까지 확인했다고 해석하지 마세요.
브랜치와 공유 위치는 무엇인가요?
브랜치는 한 저장소 안에서 이어지는 작업 흐름입니다. 팀은 하나의 흐름으로 함께 작업할 수도 있고, 기능별로 나누어 작업하다 합칠 수도 있습니다.
GitLinq는 선택한 저장소에서 현재 사용 중인 브랜치를 보여 줍니다. 서버와 연결할 때는 공유 위치도 표시합니다. 같은 프로젝트라도 공유 위치가 다르면 취소하거나 받아 올 대상이 달라질 수 있으므로 확인하는 것입니다.
브랜치를 새로 만들거나 바꾸는 방법을 몰라도 기존 저장소의 로그를 읽을 수 있습니다. 화면의 공유 위치가 팀에서 안내한 것과 다른지 모르겠다면 담당자에게 확인하세요.
‘중간 변경만 취소’하면 뒤의 작업은 어떻게 되나요?
서버에 반영된 순서
① 기본 화면 → ② 내 로그인 문구 수정 → ③ 동료의 알림 설정 추가
②만 취소할 수 있는 경우
① → ② → ③ → ④ 로그인 문구를 되돌리는 취소 커밋
②와 ③이 로그에서 사라지는 것은 아닙니다. ④를 새로 추가해 최종 파일 내용에서 ②의 효과를 되돌립니다. ③의 작업을 함께 없애지 않고 유지할 수 있는지 미리 확인합니다.
다만 ③이 ②에 꼭 필요한 내용을 추가했다면 둘을 깔끔하게 나눌 수 없을 수 있습니다. 예를 들어 ②가 새 파일을 만들고 ③이 그 파일을 수정했다면 파일만 지워서 해결할 수는 없습니다. 이런 경우 자동 취소 결과를 확정하지 않고 관련 내용을 보여 줍니다.
충돌이란 무엇인가요?
서로 다른 변경을 합치거나 일부를 되돌릴 때 어느 내용을 남겨야 하는지 자동으로 결정하기 어려운 상황입니다. 같은 줄을 다르게 고치거나, 한쪽에서는 없앨 파일을 다른 쪽에서는 수정한 경우가 예입니다.
충돌 안내가 나온다고 저장소 전체가 고장 난 것은 아닙니다. 사람이 원래 의도를 확인해야 한다는 뜻입니다. GitLinq 0.2.2는 취소 미리보기에서 관련 내용을 보여 주고 자동 실행을 멈추지만, 화면 안에서 충돌을 직접 편집해 해결하는 기능은 아직 없습니다.
‘복제’와 ‘업데이트’는 다른가요?
복제(Clone)는 서버의 Git 저장소를 내 PC에 처음 준비하는 일입니다. SVN에서 처음 작업 사본을 받는 용도와 비슷하지만 Git의 동작과 용어가 완전히 같지는 않습니다.
업데이트는 이미 내 PC에 있는 저장소에 서버의 새 변경을 받아 적용하는 일입니다. GitLinq 0.2.2는 기존 저장소의 안전한 업데이트를 지원하며, 처음 복제하는 기능은 제공하지 않습니다.
Git과 GitHub는 같은 건가요?
Git은 변경 내역을 관리하는 프로그램입니다. GitHub는 Git 저장소를 서버에 보관하고 함께 작업할 수 있도록 하는 서비스 중 하나입니다.
회사는 GitHub 대신 다른 서비스나 사내 Git 서버를 사용할 수도 있습니다. Git을 쓴다고 반드시 GitHub 계정을 만들어야 하는 것은 아닙니다. 팀에서 사용하는 서버와 접근 방법을 확인하면 됩니다.
GitLinq의 공개 설치 파일을 GitHub에서 받는 것과, 회사 프로젝트 저장소에 접속하는 것도 별개의 일입니다. 공개 GitLinq 다운로드에는 GitHub 로그인이 필요하지 않지만, 프로젝트 서버에는 그 서버가 요구하는 접근 권한이 필요할 수 있습니다.