4강. PATH와 환경 변수: 명령어가 어디서든 실행되는 이유

?1. 이번 강의에서 해결할 문제

설치 폴더에는 실행 파일이 있는데 명령을 찾지 못하거나 예상과 다른 버전이 실행됩니다. PATH의 검색 목록과 환경 변수 범위를 진단합니다.

✓2. 학습 목표

✓이 강의를 마치면

• PATH가 실행 파일 폴더 목록임을 설명합니다.
• Process, User와 Machine 환경 변수 범위를 구분합니다.
• PATH를 변경하기 전에 중복과 실행 우선순위를 확인합니다.

◇3. 핵심 개념

Windows는 PATH에 적힌 폴더를 앞에서부터 검색해 명령 이름과 맞는 실행 파일을 찾습니다. PowerShell의 Process 환경은 현재 창과 자식 프로세스에만 적용됩니다. User는 현재 사용자, Machine은 전체 컴퓨터 범위이며 Machine 변경에는 보통 관리자 권한이 필요합니다. 공식 설명은 PowerShell 환경 변수 문서에서 확인할 수 있습니다.

예를 들어 git을 입력하면 PowerShell은 명령 해석 규칙과 PATH의 폴더 순서를 따라 git.exe를 찾습니다. 같은 이름이 여러 폴더에 있으면 앞선 후보가 선택되므로 “설치는 됐는데 옛 버전이 실행되는” 문제가 생깁니다. Get-Command git -All은 후보와 우선순위를 확인하는 진단 명령입니다.

범위	지속 시간	영향
Process	현재 PowerShell이 종료될 때까지	현재 창과 여기서 실행한 자식 프로세스
User	사용자 설정을 변경할 때까지	새로 시작한 현재 사용자 프로세스
Machine	컴퓨터 설정을 변경할 때까지	모든 사용자, 보통 관리자 권한 필요

✎4. 단계별 실습

명령 목적: PATH를 변경하지 않고 세 범위의 값을 읽고, 임시 Process 변수의 수명을 확인합니다.

실행 전 상태: 일반 PowerShell을 엽니다. 이 실습은 영구 환경 변수를 설정하거나 기존 PATH를 덮어쓰지 않습니다. 출력에는 사용자 경로가 포함될 수 있으므로 공개 기록에 그대로 붙이지 않습니다.

PowerShell · 실행 위치: 어느 폴더여도 됩니다.

$env:Path -split ';' | Where-Object { $_ } | Select-Object -Unique
[Environment]::GetEnvironmentVariable('Path', 'User') -split ';'
[Environment]::GetEnvironmentVariable('Path', 'Machine') -split ';'
$env:DEV_ENV_LAB = 'current-session-only'
$env:DEV_ENV_LAB
Get-Command git -All -ErrorAction SilentlyContinue

예상 결과: PATH 항목이 한 줄씩 표시되고 임시 변수는 current-session-only를 출력합니다. Git이 설치됐다면 마지막 명령에 실행 파일 경로와 종류가 보입니다. 새 PowerShell을 열면 DEV_ENV_LAB은 존재하지 않습니다.

안전한 수정 원칙

1. 설치 프로그램의 공식 PATH 옵션을 우선합니다.
2. 실행 파일 자체가 아니라 실행 파일이 있는 폴더만 추가합니다.
3. 이미 존재하거나 사용하지 않는 경로를 중복 추가하지 않습니다.
4. 영구 수정 전 기존 User PATH를 기록하고 새 PowerShell에서 검증합니다.

macOS·Linux 차이

macOS와 Linux에서는 환경 변수 이름의 대소문자를 구분하고 PATH 항목 구분자로 세미콜론이 아닌 콜론(:)을 사용합니다. Shell 설정 파일을 수정하기 전 현재 Shell과 공식 배포판 문서를 확인하세요.

→5. 명령어와 설정이 동작하는 이유

$env:는 현재 PowerShell 프로세스가 가진 환경 변수에 접근합니다. User와 Machine 값을 합친 결과가 새 프로세스의 PATH가 되며, 이미 열린 터미널은 설치 후 변경을 자동으로 받지 않을 수 있어 다시 열어야 합니다.

-split ';'은 Windows PATH 문자열을 폴더 단위로 나누고 Select-Object -Unique는 출력에서 중복을 줄입니다. 이 명령들은 값을 읽을 뿐 수정하지 않습니다. 설치 직후 새 터미널에서 Get-Command <도구> -All과 <도구> --version을 함께 확인해야 실제 선택된 파일과 버전을 연결할 수 있습니다.

!6. 자주 하는 실수와 해결법

!자주 하는 실수

• PATH에 실행 파일 전체 경로 추가: tool.exe가 있는 폴더를 추가합니다.
• 문제마다 새 경로를 계속 추가: Get-Command -All로 실제 후보와 우선순위를 먼저 확인합니다.
• Machine PATH를 관리자 권한으로 즉시 수정: 사용자 설치라면 User 범위로 충분한지 확인합니다.
• PATH 전체를 새 문자열로 덮어씀: 기존 값을 보존하고 공식 설치 도구를 우선합니다.

✎7. 직접 실습

✎직접 실습

실습 목표

PATH를 변경하지 않고 중복·존재하지 않는 항목과 실제 실행 파일 선택 순서를 진단합니다.

시작 전 상태

일반 PowerShell을 사용합니다. 개인 경로가 포함된 전체 출력을 공개 저장소에 커밋하지 않습니다. 기존 PATH 수정은 이번 실습 범위가 아닙니다.

1단계: 따라 하기

Process, User, Machine PATH를 각각 줄별로 출력합니다. DEV_ENV_LAB 임시 변수를 만들고 같은 창에서 값을 확인합니다.

2단계: 도구 이름 바꿔 보기

Get-Command git -All을 실행한 뒤 자신에게 설치된 python, node 같은 도구 하나로 이름을 바꿉니다. 첫 후보 경로와 --version 결과를 기록합니다.

3단계: 직접 적용

Process PATH 항목 중 Test-Path가 거짓인 폴더와 중복 항목 수를 보고서로 정리합니다. 실제 PATH는 수정하지 말고 어떤 설치 프로그램이나 설정을 확인할지 제안합니다.

4단계: 스스로 확인

• 실행 파일 자체가 아니라 폴더가 PATH 항목이라는 점을 확인했나요?
• 현재 창과 새 창에서 임시 변수 결과를 비교했나요?
• 후보가 여러 개라면 앞선 경로가 선택된다는 점을 기록했나요?

막혔을 때

증상	원인	확인·해결
도구를 설치했는데 못 찾음	열린 터미널이 이전 환경을 유지	새 PowerShell을 열고 후보를 다시 확인합니다.
예상과 다른 버전	같은 이름의 후보가 PATH 앞쪽에 있음	Get-Command -All 결과와 버전을 비교합니다.
User PATH가 빈 값	User 범위에 별도 값이 없음	오류가 아니며 Process·Machine 결과와 구분합니다.
출력 공유가 걱정됨	사용자 경로가 포함됨	전체 원본 대신 문제 항목만 기록합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. tool.exe가 설치 폴더에 있지만 명령을 찾지 못합니다. PATH에는 무엇을 등록해야 하며 실제 후보는 어떻게 확인하나요?
2. 설치 후 기존 터미널에서는 못 찾지만 새 터미널에서는 동작합니다. Process 환경의 어떤 특성 때문인가요?
3. 같은 도구의 두 버전이 검색될 때 실행 버전을 어떻게 판단하며, 무작정 Machine PATH를 고치면 안 되는 이유는 무엇인가요?

■9. 핵심 요약

■핵심 요약

PATH는 명령 실행 파일을 찾는 순서 있는 폴더 목록입니다. 범위와 우선순위를 확인하고 필요한 폴더 하나만 추가하며, 기존 값을 기록한 뒤 새 터미널에서 검증합니다.

§10. 다음 강의 연결

명령 검색 경로와 환경 변수 범위를 읽을 수 있게 되었습니다. 다음 강의에서는 경로·버전·간단 실행 결과를 함께 확인해 설치 성공을 검증합니다.