심볼릭 링크(Symbolic) 정의 및 사용 방법

0. 들어가기 전에

※ 본 글에서는 이해를 쉽게 하기 위해 아래와 같은 예시 경로를 사용하였습니다.

원본 이미지 데이터 폴더:
D:\image data

AI 학습 프로젝트 폴더:
C:\AI_Project\data

실제 사용 환경에서는 본인이 사용하는 드라이브 및 폴더 경로에 맞게 변경해서 사용하면 됩니다.

 

1. 심볼릭 링크(Symbolic Link)란?

심볼릭 링크(Symbolic Link)는 실제 파일이나 폴더를 복사하지 않고 다른 위치에 있는 원본 폴더를 연결해서 사용하는 기능이다.

쉽게 말하면 실제 원본 폴더가 아래 위치에 있는데,
D:\image data\가지

프로젝트 진행할때는 아래 위치에 있는거 처럼 보이도록 하는 것
C:\AI_Project\data\가지

 

 

즉 정리하자면, 

로컬의 C 드라이브를 열어도
C:\AI_Project\data\가지

실제로는 D 드라이브 안으로 들어가지는 구조
D:\image data\가지

 

 

2. 심볼릭 링크를 왜 사용할까?

• 데이터 복사 방지
  • AI 학습 데이터는 용량이 매우 크다.
  • 예를 들어
    

    이미지 10만 장
    클래스 수십 개
    프로젝트 여러 개
    
    =>이런 상황에서 프로젝트마다 데이터를 복사하면 SSD 용량이 금방 부족해진다

    하지만 심볼릭 링크를 사용하면
    
    • 실제 데이터는 한 곳에만 저장
    • 프로젝트에서는 복사 없이 연결하여 사용 가능
      
      
      
• 학습 코드가 일반 폴더처럼 인식
  • YOLO, PyTorch, OpenCV 같은 학습 코드들은 대부분 심볼릭 링크를 일반 폴더처럼 인식한다.
  • 예를 들어 코드에서
    

    C:\AI_Project\data\가지 => 데이터를 읽더라도,
    실제로는
    
    D:\image data\가지 => 에서 가져옴
    
    - 코드 수정 필요 거의 없음
    - 데이터 관리 편리
    - 프로젝트 구조 깔끔

 

3. 심볼릭 링크 만드는 방법

• 방법 1. CMD에서 하나씩 만들기
  
  • CMD 관리자 권한 실행
    

    윈도우 검색창에 "cmd" 입력 후 -> "관리자 권한으로 실행"

  • 프로젝트 폴더 생성
    

    mkdir "C:\AI_Project\data"

  • 심볼릭 링크 생성
    

    mklink /D "C:\AI_Project\data\test" "D:\image data\test"
    
    // 명령어 구조
    mklink /D "링크 위치" "실제 원본 위치"

     

 

4. Windows에서는 Junction(/J)도 많이 사용

실무에서는 폴더 연결 시 /J 옵션도 많이 사용한다. 

mklink /J "C:\AI_Project\data\가지" "D:\image data\가지"

 

• /D 와 /J 차이
  

  명령어	의미	특징
  /D	심볼릭 링크	일반 symbolic link
  /J	Junction 링크	Windows 폴더 연결에 안정적

 

5. 여러 폴더 한 번에 연결하기

폴더가 수십 개라면 하나씩 만드는 건 비효율적이다. PowerShell을 사용하면 자동으로 한 번에 생성 가능하다.

• PowerShell 관리자 권한 실행 후 입력
  

  $source = "D:\image data”
  $target = “C:\AI_Project\data”
  
  New-Item –ItemType Directory –Force –Path $target
  
  Get-ChildItem $source –Directory | ForEach-Object {
      $linkPath = Join-Path $target $_.Name
      cmd /c mklink /D "$linkPath" "$($_.FullName)"
  }

   
• 실행 결과

 

6. 새 폴더만 추가 생성하는 방법

이미 링크가 있는 폴더는 건너뛰고, 새롭게 추가된 폴더만 생성하려면 아래 명령어 실행

$source = "D:\image data"
$target = "C:\AI_Project\data"

New-Item -ItemType Directory -Force -Path $target

Get-ChildItem $source -Directory | ForEach-Object {
    $linkPath = Join-Path $target $_.Name

    if (!(Test-Path $linkPath)) {
        cmd /c mklink /D "$linkPath" "$($_.FullName)"
    }
}

 

7. 심볼릭 링크 확인 방법

CMD에서

cd "C:\AI_Project\data"

-> 이동 후

dir

입력

 

• 정상 생성 시

 

8. 삭제 시 주의사항

• 심볼릭 링크된 폴더 삭제
  

  C:\AI_Project\data\가지
  
  삭제시
  -> 링크만 삭제됨
  -> 원본 데이터 유지

• (주의) 심볼릭 링크된 폴더 안에 들어가서 파일 삭제시 => 원본 폴더 안의 파일도 삭제됨
  

  즉, C:\AI_Project\data\가지 폴더안의 사진 파일 하나 삭제시
  D:\image data\가지 폴더 안에 있는 사진 파일 동일하게 삭제 됨

   

 

9. 최종 정리

심볼릭 링크(Symbolic Link)는 실제 데이터를 복사하지 않고 다른 위치의 폴더를 연결해서 사용하는 기능이다.

 

특히 AI 이미지 학습에서는 저장공간 절약, 데이터 관리 효율화, 프로젝트 구조 정리에 유용하다.