SNOMET / 개발 자료Rust 공식 학습 자료 ↗

Rust로 무엇을
만들 수 있을까?

반복 작업을 처리하는 실행 파일부터 PC 앱, API 서버까지.
웹 개발자가 Rust를 시작할 때 필요한 선택과 방법을 모았습니다.

Rust는 성능과 메모리 안전성을 함께 고려하는 프로그래밍 언어입니다. 소유권과 빌림 규칙을 컴파일 단계에서 검사하며, 가비지 컬렉터 없이 메모리를 관리합니다. 안전한 Rust 코드의 보장과 unsafe·외부 라이브러리의 책임 범위는 구분해서 이해해야 합니다. 소유권 공식 설명 ↗

지금 하던 웹 개발에 붙인다면

PHP 사이트는 유지하고, 필요한 기능부터 분리하세요. 파일 일괄 처리라면 CLI, 로컬 프로그램이라면 Tauri, 별도 서버 기능이라면 API, 브라우저 계산이라면 WebAssembly가 출발점입니다.

소개 페이지·폼·일반 CRUD가 목적이면 기존 PHP나 JavaScript만으로도 충분할 수 있습니다. Rust 도입 여부는 실제 병목, 배포 환경, 팀의 유지보수 경험으로 판단하세요.

용도부터 고르세요

아래 구성은 시작점을 제안한 편집 가이드입니다. 같은 용도에도 다른 도구를 선택할 수 있습니다.

6가지 사용처

파일·업무 자동화반복 작업을 실행 파일 하나로

폴더 정리, 이미지 변환 도구, 로그 분석, CSV 검증처럼 입력과 출력이 명확한 작업부터 시작하기 좋습니다.

시작 구성 · 표준 라이브러리 → clap → serde

기존 스크립트보다 배포·성능이 중요할 때 검토하세요. 간단한 일회성 작업은 Python이 더 빠르게 끝날 수 있습니다.

파일·업무 자동화 공식 자료 ↗

PC 프로그램웹 화면에 로컬 기능 연결하기

HTML·CSS·React 등으로 화면을 만들고, Rust로 파일 처리와 운영체제 기능을 연결하는 Tauri 방식입니다.

시작 구성 · Tauri + 기존 웹 프런트엔드

OS별 빌드 환경·서명·설치 파일 검증이 필요합니다. 웹 코드를 그대로 넣는 것만으로 모든 기능이 완성되지는 않습니다.

PC 프로그램 공식 자료 ↗

API·네트워크 서버요청을 받고 데이터를 처리하기

API 라우팅과 JSON 응답을 구현하고 비동기 I/O를 활용합니다. 기존 PHP 사이트와 별도 서비스로 연결할 수 있습니다.

시작 구성 · Axum + Tokio + Serde

공유 호스팅에서 PHP 파일처럼 업로드해 실행하는 방식은 아닙니다. 실행 프로세스와 리버스 프록시 등 운영 구성이 필요합니다.

API·네트워크 서버 공식 자료 ↗

브라우저 연산무거운 계산 부분만 Rust로

이미지·데이터 처리 등 계산 로직을 WebAssembly로 컴파일해 JavaScript에서 호출하는 방식입니다.

시작 구성 · wasm-bindgen + JavaScript

DOM·화면 구성은 웹 기술과 연결합니다. 데이터 전달 비용 때문에 모든 코드가 자동으로 빨라지는 것은 아닙니다.

브라우저 연산 공식 자료 ↗

임베디드·시스템메모리와 하드웨어를 직접 다루기

마이크로컨트롤러나 제한된 환경에서 하드웨어에 가까운 코드를 작성할 수 있습니다.

시작 구성 · Embedded Rust + 대상 보드 도구

지원 보드, 타깃, 디버거와 no_std 제약을 먼저 확인하세요. 입문용 첫 프로젝트로는 난도가 높습니다.

임베디드·시스템 공식 자료 ↗

게임·도구 제작작은 게임이나 콘텐츠 도구부터

Rust 기반 엔진으로 게임을 만들거나 게임 데이터 변환·검증 도구를 만들 수 있습니다.

시작 구성 · Bevy 또는 독립 CLI 도구

엔진 버전별 API 변화와 필요한 플랫폼 지원을 확인하세요. 기존 게임을 전부 바꾸기보다 작은 도구부터 권합니다.

게임·도구 제작 공식 자료 ↗

설치하고 첫 프로젝트 실행하기

아래 명령은 안내용입니다. 이 웹페이지에서는 설치나 컴파일을 실행하지 않습니다.

Windows

공식 설치 페이지에서 CPU에 맞는 rustup-init.exe를 내려받아 실행합니다. MSVC 빌드 도구가 필요한 경우 설치 안내를 따르세요. 설치 후 터미널을 새로 엽니다.

macOS · Linux · WSL

같은 공식 페이지의 rustup 설치 안내를 사용합니다. 컴파일러·링커 등 운영체제별 필수 도구도 확인하세요.

터미널 · Rust 설치 후
rustc --version
cargo --version
cargo new hello_rust
cd hello_rust
cargo run

src/main.rs를 수정하고 cargo run으로 다시 실행합니다. 에디터는 VS Code와 rust-analyzer 조합 등을 사용할 수 있습니다.

Cargo 자주 쓰는 명령
명령언제 쓰나요?
cargo check실행 파일 생성 없이 컴파일 가능 여부를 확인할 때
cargo run개발 중 빌드하고 실행할 때
cargo test작성한 테스트를 실행할 때
cargo fmt --check서식 규칙을 확인할 때 · 수정은 cargo fmt
cargo clippy추가 코드 품질 경고를 확인할 때
cargo build --release최적화한 배포용 바이너리를 만들 때
cargo doc --open프로젝트와 의존성 API 문서를 열 때

대부분의 일반 프로젝트에서 결과물은 target/release/ 아래에 생성됩니다. 배포 대상 OS·CPU에 맞는 빌드와 실제 실행 검증은 별도입니다. Cargo 문서 ↗

먼저 익힐 핵심 개념

소유권 · Ownership
값을 관리하는 주체와 정리 시점을 다룹니다. 일부 값은 대입·함수 전달 시 소유권이 이동합니다. 복사 가능한 타입은 다르게 동작합니다.
빌림 · Borrowing
&T로 읽기 참조, &mut T로 변경 가능한 참조를 사용합니다. 유효한 참조와 접근 규칙을 컴파일러가 검사합니다.
수명 · Lifetime
참조가 유효한 범위 사이의 관계입니다. 대부분 추론되며, 수명 표기는 데이터가 살아 있는 시간을 강제로 늘리지 않습니다.
Option / Result
Option<T>는 값의 유무, Result<T, E>는 성공과 실패를 표현합니다. match·?로 분기하거나 오류를 전달합니다.
Trait / Generic
타입이 제공하는 동작과 공통 제약을 표현합니다. 여러 타입에서 재사용할 코드를 작성할 때 익힙니다.
async / await
비동기 작업을 표현하는 문법입니다. Tokio 같은 실행 환경과 함께 사용하며, CPU 계산을 자동으로 병렬화하는 문법은 아닙니다.

The Rust Programming Language에서 순서대로 읽기 ↗

컴파일 오류가 많으면 어떻게 하나요?

오류 메시지의 코드 위치와 제안을 먼저 읽고, 값이 이동했는지·참조가 너무 오래 유지되는지 확인하세요. 무조건 clone()이나 unsafe를 추가하기보다 데이터 소유 관계를 먼저 정리합니다. rustc --explain E0382처럼 오류 코드 설명도 확인할 수 있습니다.

직접 만들어 볼 예제: 텍스트 줄 수 세기

외부 패키지 없이 파일 경로를 받고 줄 수를 출력하는 최소 CLI입니다. UTF-8 텍스트 파일을 대상으로 하며, 오류는 실행 결과로 전달합니다.

src/main.rs
use std::{env, error::Error, fs, io};

fn main() -> Result<(), Box<dyn Error>> {
    let path = env::args().nth(1).ok_or_else(|| {
        io::Error::new(io::ErrorKind::InvalidInput,
                       "사용법: cargo run -- 파일경로")
    })?;
    let text = fs::read_to_string(&path)?;
    println!("{}: {}줄", path, text.lines().count());
    Ok(())
}

새 프로젝트의 src/main.rs를 교체하고 프로젝트 폴더에 UTF-8 파일 sample.txt를 만들어 실행하세요.

프로젝트 폴더에서 실행
cargo run -- sample.txt

예: 두 줄짜리 파일은 sample.txt: 2줄을 출력합니다. 끝의 줄바꿈만으로 추가 빈 줄을 세지는 않습니다. 전체 파일을 메모리에 읽으므로 매우 큰 파일은 BufRead 기반 방식으로 확장하세요.

필요할 때 찾아볼 도구

처음부터 전부 설치할 필요는 없습니다. Cargo 기본 흐름을 익힌 뒤 프로젝트에 필요한 도구만 선택하세요.

AI와 함께 개발한다면

작은 입력·출력 예시와 완료 조건부터 정하고, 코드를 받은 뒤 직접 빌드·실행 결과로 확인하세요. 이 요청문은 SNOMET에서 작성한 예시입니다.

첫 프로젝트 요청문
Rust로 UTF-8 텍스트 파일의 줄 수를 세는 CLI를 만들어줘.
먼저 입력·출력과 오류 처리 방식을 설명하고 최소 구현부터 진행해줘.
없는 파일, 빈 파일, 한글 경로, 잘못된 인자도 확인해줘.
외부 crate는 필요한 이유를 설명하고 공식 문서의 API를 확인해줘.
cargo check, fmt --check, clippy, test와 실제 실행 결과를 구분해 보고해줘.
실행하지 못한 검증은 통과했다고 쓰지 말고 남겨줘.
  1. 작게 정의 · OS, 입력 파일 형식, 출력 예시와 실패 조건을 정합니다.
  2. 기본 구현 · 소유권·오류 처리부터 이해하고 필요한 의존성만 추가합니다.
  3. 검증 · 컴파일·테스트와 실제 입력 파일 실행을 따로 확인합니다.
  4. 배포 · 라이선스·대상 환경·파일 접근 범위와 설치 방식을 확인합니다.

기존 웹 프로젝트라면 “현재 PHP 화면은 유지하고, 파일 변환만 Rust CLI로 분리해 줘”처럼 경계를 지정하세요. 화면 전체를 바꾸는 작업과 연산 부분을 분리하는 작업은 규모가 다릅니다.

다음으로 읽을 자료

이 페이지는 공식 번역이 아닌 한국어 편집 가이드입니다. 도구 API와 설치 조건은 연결된 공식 문서에서 확인하세요. 성능·개발 시간·배포 용량은 프로젝트와 환경에 따라 달라집니다.