Windows에서 PATH에 Git 추가

Windows의 모든 작업 디렉터리에서 Git 명령을 실행하려면 Git의 명령줄 실행 파일이 포함된 디렉터리를 PATH 환경 변수에 추가하세요. Windows 환경 변수에서 추가하거나 PowerShell로 영구적으로 추가할 수 있습니다. 그런 다음 새 터미널을 열고 Git 버전을 확인하세요.

Windows에서 PATH에 Git 추가

PATH는 명령을 입력할 때 Windows가 검색하는 디렉터리 목록입니다. git.exe 파일 자체가 아니라 디렉터리를 추가하세요. 일반적인 Git for Windows 설치에서는 C:\Program Files\Git\cmd를 사용합니다. 형제 디렉터리인 bin은 다른 Git 유틸리티에 유용할 수 있지만, 해당 도구가 필요할 때만 추가하세요. Git이 다른 곳에 설치되어 있으면 먼저 해당 cmd 디렉터리를 찾으세요.

사용자 Path 또는 시스템 Path 중 하나를 편집할 수 있습니다. 사용자 항목은 자신의 Windows 계정에 적용되며 일반적으로 관리자 액세스가 필요하지 않습니다. 시스템 항목은 모든 사용자에게 적용되며 관리자 권한이 필요합니다.

1. Windows에서 시스템 환경 변수 편집을 검색하여 엽니다.

   

2. 시스템 속성에서 환경 변수를 선택합니다. 내 PC를 마우스 오른쪽 버튼으로 클릭하고 속성을 선택한 뒤 고급 시스템 설정을 열어도 시스템 속성에 접근할 수 있습니다.

   

3. 사용자 변수 또는 시스템 변수에서 Path를 선택한 다음 편집을 선택합니다. 자신의 계정으로 제한되는 변경에는 사용자 항목을 선택하세요.

   

4. 새로 만들기를 선택하고 Git의 cmd 디렉터리(예: C:\Program Files\Git\cmd)를 입력한 뒤 대화 상자를 저장합니다. C:\Program Files\Git\bin\git.exe를 입력하지 마세요. PATH 항목은 디렉터리여야 합니다.

   

PortableGit의 경우 위치는 C:\Users\<user>\AppData\Local\GitHub\PortableGit_<guid> 아래에 있을 수 있습니다. 컴퓨터의 실제 설치를 확인한 다음 해당 cmd 디렉터리를 추가하세요. 해당 bin 디렉터리는 그곳의 추가 유틸리티가 필요할 때만 추가하세요.

PowerShell로 PATH에 Git 추가

PowerShell은 기존 항목을 바꾸지 않고 사용자 PATH에 디렉터리를 영구적으로 저장할 수 있습니다. 다음의 자체 완결형 예제는 Git이 표준 Program Files 위치에 설치되어 있다고 가정합니다. 해당 디렉터리를 확인하고 아직 없을 때만 추가합니다. 이 Windows 전용 예제는 제공된 런타임 증거에서 실행되지 않았습니다. 사용하기 전에 설치 위치를 확인하세요.

$gitCmd = Join-Path $env:ProgramFiles 'Git\cmd'
if (Test-Path -LiteralPath $gitCmd -PathType Container) {
    $userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
    $entries = @($userPath -split ';' | Where-Object { $_ })
    $alreadyPresent = $entries | Where-Object { $_.TrimEnd('\') -ieq $gitCmd.TrimEnd('\') }
    if (-not $alreadyPresent) {
        $newPath = (@($entries) + $gitCmd) -join ';'
        [Environment]::SetEnvironmentVariable('Path', $newPath, 'User')
    }
}

User 대상은 계정의 영구 PATH를 변경합니다. 관리자 권한으로 승격된 PowerShell 창이 필요하지 않습니다. Git이 다른 위치에 설치되어 있으면 $gitCmd를 해당 설치의 cmd 디렉터리로 설정하세요. $env:Path만 변경하면 현재 PowerShell 프로세스와 그 자식 프로세스에만 영향을 미치므로 이 방법의 영구적인 대체가 되지 않습니다.

새 터미널에서 Git 확인

기존 명령 프롬프트 또는 PowerShell 창을 닫고 새 창을 연 뒤 git --version을 실행하세요. 새 터미널은 업데이트된 환경을 받습니다. 이미 열려 있던 터미널은 이전 PATH를 그대로 가지고 있을 수 있습니다.

명령이 버전을 출력하면 Windows가 이름으로 Git을 찾을 수 있다는 뜻입니다. 이는 명령 검색을 확인하는 것이며, 리포지터리나 Git 구성을 확인하는 것은 아닙니다.

Git이 인식되지 않을 때 문제 해결

새 터미널에서 git이 인식되지 않는다고 보고하면 다음 항목을 확인하세요.

• Git이 설치되어 있는지, 추가한 cmd 디렉터리가 존재하는지 확인하세요. 기본값은 일반적으로 C:\Program Files\Git\cmd이지만 설치 프로그램이나 PortableGit은 다른 위치를 사용할 수 있습니다.
• 환경 변수에서 해당 디렉터리가 Path 항목으로 나타나는지 확인하세요. 항목은 git.exe가 아니라 cmd로 끝나야 합니다.
• 변경을 저장한 뒤 새 터미널을 다시 여세요. 기존 창은 PATH를 자동으로 다시 로드하지 않습니다.
• 시스템 Path를 편집했다면 변경이 관리자 권한으로 저장되었는지 확인하세요. 단일 계정에는 대신 사용자 Path를 사용하세요.

올바른 디렉터리가 PATH에 있으면 새 터미널에서 git --version을 실행했을 때 설치된 버전이 표시되어야 합니다.