Visual Studio Code에서 Swift 실행하는 방법

개발/iOS - Swift1 2025. 10. 15. 12:35

Swift는 원래 Xcode에서 많이 사용하는 언어지만,

윈도우나 리눅스 환경에서도 충분히 개발하고 실행할 수 있습니다.

 

특히 Visual Studio Code(이하 VS Code)를 이용하면

가볍고 자유롭게 Swift 코드를 다뤄볼 수 있는데요.

오늘은 VS Code에서 Swift를 실행하는 방법을 하나씩 알아보겠습니다.

 


1. Swift 설치하기

먼저 Swift 컴파일러가 있어야 VS Code에서도 실행이 가능합니다.

운영체제에 따라 아래 사이트에서 설치 파일을 내려받으시면 됩니다.

 

👉 Swift 공식 다운로드 페이지

 

1) macOS에서 설치 확인

macOS는 대부분 Xcode에 Swift가 포함되어 있습니다.

만약 별도로 Swift를 설치하셨다면, 터미널을 열고 아래 명령어로 버전을 확인하세요.

swift --version

 

정상적으로 설치되어 있다면

예를 들어 다음과 같이 버전 정보가 표시됩니다.

Apple Swift version 5.10 (swiftlang-5.10.0.13 clang-1500.0.40.1)
Target: arm64-apple-darwin23.3.0

만약 “command not found: swift”라고 나온다면

Xcode Command Line Tools를 다시 설치하거나, Swift.org에서 별도 설치가 필요합니다.

xcode-select --install

이 명령으로 기본 툴셋을 다시 세팅할 수 있습니다.

 


2) Windows에서 설치 확인

윈도우 사용자는 Swift.org에서 제공하는 Windows용 설치 패키지(.msi) 를 설치해야 합니다.

설치 후 명령 프롬프트(cmd)PowerShell을 열고 아래 명령어를 입력하세요.

swift --version

 

정상적으로 설치되었다면 Swift 버전 정보가 출력됩니다.

 

만약 “swift를 찾을 수 없습니다”라는 오류가 나오면,

환경 변수에 Swift 경로가 제대로 추가되지 않은 경우가 많습니다.

 

설치 폴더(보통 C:\Library\Developer\Toolchains\swift-버전\usr\bin)를

PATH 환경 변수에 추가한 뒤 다시 시도해보세요.

 


 

2. Visual Studio Code 설치 및 준비

이제 VS Code를 설치해볼까요?

아직 설치하지 않으셨다면 VS Code 공식 홈페이지에서 내려받아주세요.

 

설치 후 Swift 개발을 위해 확장 기능(Extension) 도 추가해야 합니다.

왼쪽 메뉴의 Extensions 아이콘(네모 4개 모양)을 클릭한 뒤

Swift를 검색해서 Swift 확장을 설치하면 됩니다.


 

3. Swift 파일 만들기

이제 간단한 Swift 파일을 하나 만들어볼게요.

VS Code에서 새로운 파일을 열고 이름을 main.swift로 저장합니다.

print("Hello, Swift in VS Code!")

이렇게 한 줄만 써도 충분합니다.

 


 

4. Swift 코드 실행하기

VS Code 상단 메뉴에서 터미널 → 새 터미널을 열고 아래 명령어를 입력하세요.

swift main.swift

그러면 터미널에

Hello, Swift in VS Code!

라고 출력될 거예요.

이렇게 Swift가 VS Code에서 정상적으로 실행됩니다.

 


 

5. 프로젝트 단위로 실행하고 싶을 때

단일 파일이 아니라 Swift 패키지 프로젝트 형태로 실행하고 싶다면,

터미널에서 새 폴더를 만들고 다음 명령어를 입력하세요.

swift package init --type executable

그럼 기본적인 Swift 프로젝트 구조가 생성됩니다.

이후 아래 명령어로 빌드와 실행이 가능합니다.

swift run

 


마무리

이제 VS Code에서도 Xcode 없이 Swift 코드를 마음껏 작성하고 실행할 수 있습니다.

가볍게 공부하거나 간단한 테스트를 할 때 아주 유용하죠.

윈도우, 맥, 리눅스 어디서든 Swift를 손쉽게 다뤄보세요.

반응형
admin