A - 키워드

이 부록은 Rust 문법을 다시 가르치기보다, 컴파일 오류가 가리키는 단어를 Rust 2024 키워드 분류와 식별자 문맥으로 빠르게 되찾는 참조 색인입니다.

부록 A: 키워드

Rust Reference는 키워드를 엄격 키워드(strict), 예약 키워드(reserved), **약한 키워드(weak)**로 구분합니다. 에디션은 Rust 컴파일러 버전과 별개인 소스 호환성 경계이며, 이 페이지는 Rust 2024를 기준으로 합니다.

엄격 키워드

엄격 키워드는 사용하는 에디션에서 일반 식별자로 쓸 수 없습니다. _도 이름 없는 패턴·자리표시자 등에 특별한 의미가 있는 엄격 키워드입니다.

as, async, await, break, const, continue, crate, dyn, else, enum, extern, false, fn, for, if, impl, in, let, loop, match, mod, move, mut, pub, ref, return, Self, self, static, struct, super, trait, true, type, unsafe, use, where, while, _

자주 혼동하는 몇 가지는 다음처럼 읽습니다.

• async 함수와 블록은 Future를 만듭니다. .await는 그 Future가 준비되지 않았을 때 현재 비동기 작업이 실행자에게 제어를 양보할 수 있는 지점입니다. 이 문법만으로 동기 CPU 작업이 자동으로 비차단 작업이 되지는 않습니다.
• const는 상수 아이템과 상수 문맥에 쓰이며, *const T에서는 해당 원시 포인터를 통해 pointee를 변경할 수 없음을 나타냅니다. “상수 원시 포인터”라는 별도 아이템을 선언하는 뜻은 아닙니다.
• pub은 허용된 아이템·필드·연관 아이템·재노출의 가시성을 지정합니다. pub impl Type { ... }처럼 impl 블록 자체 앞에 붙이는 문법은 유효하지 않습니다.
• static은 정적 아이템을 선언하는 엄격 키워드입니다. 프로그램 전체에 유효할 수 있는 라이프타임 이름 'static은 아래의 약한 키워드이며 둘은 같은 문법 범주가 아닙니다.

예약 키워드

예약 키워드는 현재 일반 문법 역할이 없더라도 향후 호환성을 위해 일반 식별자로 사용할 수 없습니다. Rust 2024에서 gen이 이 목록에 포함됩니다.

abstract, become, box, do, final, gen, macro, override, priv, try, typeof, unsized, virtual, yield

약한 키워드

약한 키워드는 특정 문맥에서만 특별한 의미를 갖습니다. 문맥 밖에서는 같은 철자가 식별자로 허용될 수 있으므로 엄격·예약 목록과 같은 방식으로 해석하면 안 됩니다.

'static, macro_rules, raw, safe, union

union은 union 아이템 선언에서, macro_rules는 선언형 매크로 문법에서 특별하게 해석됩니다. raw와 safe도 Rust 2024의 정해진 문맥에서 약한 키워드로 동작합니다.

원시 식별자

다른 에디션이나 다른 언어에서 온 API가 키워드와 충돌할 때 r#name 문법으로 strict 또는 reserved 키워드를 식별자 위치에서 사용할 수 있습니다. 직접 소유한 이름이라면 장기적으로는 명확한 새 이름으로 바꾸는 편이 낫고, 원시 식별자는 주로 상호 운용성과 기존 공개 API 호출에 사용합니다.

예를 들어 match를 그대로 함수 이름으로 쓰면 식별자가 와야 할 자리에 키워드가 나타났다는 진단을 받습니다.

fn match(needle: &str, haystack: &str) -> bool {
    haystack.contains(needle)
}

error: expected identifier, found keyword `match`
 --> src/main.rs:1:4
  |
1 | fn match(needle: &str, haystack: &str) -> bool {
  |    ^^^^^ expected identifier, found keyword

외부 계약 때문에 이름을 유지해야 한다면 정의와 호출에서 원시 식별자를 사용합니다.

fn r#match(needle: &str, haystack: &str) -> bool {
    haystack.contains(needle)
}

fn main() {
    assert!(r#match("foo", "foobar"));
}

r#는 식별자 내용에 포함되지 않는 문법 접두사입니다. 따라서 r#foo와 foo는 서로 다른 두 이름을 만드는 표기가 아닙니다.

엄격·예약 키워드라도 다음 다섯 표기는 허용되지 않습니다.

• r#_
• r#crate
• r#self
• r#Self
• r#super

예를 들어 Rust 2015 라이브러리가 공개한 try 함수를 Rust 2018 이후 코드에서 호출해야 한다면 r#try()로 적을 수 있습니다. 여기서 차이는 “Rust 버전”이 아니라 크레이트가 선택한 에디션입니다.

에디션 마이그레이션

소유한 크레이트를 다음 에디션으로 옮길 때는 먼저 현재 에디션 상태에서 다음 명령을 실행합니다.

cargo fix --edition

이 명령은 에디션 호환 lint를 바탕으로 소스를 수정하지만 Cargo.toml의 edition 값은 바꾸지 않습니다. 변경을 검토하고 테스트한 뒤 manifest를 명시적으로 갱신합니다.

[package]
edition = "2024"

마지막으로 전체 테스트와 공개 API 호출부를 확인합니다. 소유한 심볼은 의미가 드러나는 이름으로 변경하고, 이름을 바꿀 수 없는 외부·생성 코드 경계에만 원시 식별자를 남기면 에디션 차이와 상호 운용 목적이 분명해집니다.