platform setup

링커 오류는 러스트 문법보다 빌드 도구 상태를 먼저 본다

rustup은 러스트 도구체인을 설치하지만, 일부 크레이트와 링커는 운영체제별 C/C++ 빌드 도구가 준비되어 있어야 안정적으로 컴파일됩니다.

Win

Windows는 MSVC 워크로드

  • C++ 데스크톱 개발 워크로드를 확인합니다.
  • Windows 10 또는 11 SDK가 함께 필요합니다.
mac

macOS는 Xcode 명령줄 도구

  • xcode-select 설치 여부를 확인합니다.
  • C 컴파일러와 링커가 함께 들어옵니다.
Lin

Linux는 배포판 패키지

  • GCC 또는 Clang이 있는지 먼저 확인합니다.
  • 우분투 계열은 build-essential을 준비합니다.

설치 뒤 첫 실패를 좁히는 순서

명령을 못 찾음

터미널을 새로 열고 PATH가 반영되었는지 확인합니다.

cmd와 PowerShell을 섞었다면 같은 셸에서 다시 실행합니다.

링커 오류

rustc 문제가 아니라 C/C++ 빌드 도구 누락일 가능성이 큽니다.

운영체제별 준비물부터 설치한 뒤 같은 명령을 반복합니다.

버전 확인 실패

rustc --version 과 cargo --version 을 나눠 봅니다.

둘 중 하나만 실패하면 rustup 구성과 PATH 문제를 분리합니다.

설치 장의 핵심은 "러스트를 내려받았다"에서 끝나지 않습니다. 첫 예제를 컴파일할 수 있도록 rustup, 셸, PATH, 운영체제 빌드 도구가 한 묶음으로 맞춰졌는지 확인하는 데 있습니다.