E - 에디션

러스트를 쓰다 보면 컴파일러의 버전과 크레이트의 에디션이 둘 다 "버전"처럼 보여 헷갈리기 쉽습니다. 둘은 서로 다른 것을 고릅니다. 아래 표는 툴체인의 버전과 크레이트의 에디션이 각각 무엇을 정하는지 나란히 비교한 것입니다.

툴체인은 rustup이나 CI 이미지, rust-toolchain.toml로 컴파일러의 릴리스를 고르며, 그 릴리스에서 안정화된 기능과 진단, 코드 생성, 지원하는 대상을 정합니다. 툴체인을 올려도 Cargo.toml의 edition 값은 바뀌지 않으며, 그 컴파일러 릴리스보다 먼저 나온 에디션을 지원합니다. 에디션은 각 패키지의 Cargo.toml에 2015, 2018, 2021, 2024 가운데 하나로 적으며, 키워드와 경로, 프렐류드와 메서드 해석, 클로저의 캡처와 값이 버려지는 방식 같은 언어와 표준 라이브러리의 호환 동작을 고릅니다. 예를 들어 배열의 .into_iter()를 해석하는 방식은 2021 에디션부터 달라졌습니다. 에디션은 Cargo의 해석기(resolver)와 rustfmt의 스타일 기본값에도 이어지며, 최상위 패키지가 2021이면 해석기 2, 2024이면 해석기 3이 기본입니다. 해석기는 작업공간 전체에 적용되며 명시한 값이 기본값보다 앞서고, rustfmt의 서식은 style_edition으로 따로 정할 수 있습니다. Cargo는 각 크레이트에 알맞은 에디션을 넘겨 컴파일하므로, 지원하는 범위 안에서는 에디션이 다른 크레이트들도 같은 의존성 그래프에서 서로 이어 쓸 수 있습니다.

부록 E - 에디션

1장에서 cargo new가 Cargo.toml 파일에 에디션에 관한 메타데이터를 조금 더한다는 것을 보았습니다. 이 부록에서는 그것이 무엇을 뜻하는지 이야기합니다.

러스트 언어와 컴파일러는 6주의 릴리스 주기를 가지므로, 사용자는 새 기능을 꾸준히 받습니다. 다른 프로그래밍 언어는 큰 변경을 드물게 릴리스하지만, 러스트는 작은 업데이트를 더 자주 릴리스합니다. 시간이 지나면 이 작은 변경들이 쌓입니다. 하지만 릴리스마다 돌아보며 "와, Rust 1.10과 Rust 1.31 사이에 러스트가 많이 바뀌었구나!"라고 말하기는 어려울 수 있습니다.

러스트 팀은 대략 3년마다 새 러스트 에디션(edition)을 만듭니다. 각 에디션은 이미 들어간 기능들을 문서와 도구까지 완전히 갖춘 하나의 분명한 묶음으로 모읍니다. 새 에디션은 평소의 6주 릴리스 과정의 일부로 나옵니다.

에디션은 사람들마다 서로 다른 목적을 가집니다.

이 글을 쓰는 시점에 쓸 수 있는 러스트 에디션은 Rust 2015, Rust 2018, Rust 2021, Rust 2024 네 가지입니다. 이 교재는 Rust 2024 에디션의 관용구로 쓰였습니다.

Cargo.toml의 edition 키는 컴파일러가 코드에 어느 에디션을 써야 하는지 나타냅니다. 이 키가 없으면 러스트는 하위 호환성 때문에 2015를 에디션 값으로 씁니다.

각 프로젝트는 기본인 2015 에디션이 아닌 다른 에디션을 고를 수 있습니다. 에디션에는 코드의 식별자와 충돌하는 새 키워드를 도입하는 것처럼, 호환되지 않는 변경이 들어 있을 수 있습니다. 하지만 그런 변경을 고르지 않는 한, 쓰는 러스트 컴파일러의 버전을 올려도 코드는 계속 컴파일될 것입니다.

모든 러스트 컴파일러는 그 컴파일러가 릴리스되기 전에 있던 모든 에디션을 지원하며, 지원하는 어떤 에디션의 크레이트든 함께 링크할 수 있습니다. 컴파일러는 크레이트마다 그 크레이트의 에디션 규칙으로 소스를 해석하지만, 어느 에디션으로 쓴 코드든 컴파일러 안에서는 결국 같은 내부 표현으로 바뀝니다. 그러므로 Rust 2015를 쓰고 있고 의존성 하나가 Rust 2018을 쓰더라도, 프로젝트는 컴파일되고 그 의존성을 쓸 수 있습니다. 반대로 프로젝트가 Rust 2018을 쓰고 의존성이 Rust 2015를 쓰는 상황도 동작합니다.

분명히 하자면, 대부분의 기능은 모든 에디션에서 쓸 수 있습니다. 어느 러스트 에디션을 쓰는 개발자든, 새 안정 릴리스가 나오면 계속 개선을 볼 것입니다. 하지만 어떤 경우에는, 주로 새 키워드가 더해질 때, 일부 새 기능은 나중의 에디션에서만 쓸 수 있습니다. 그런 기능을 쓰고 싶다면 에디션을 바꿔야 합니다.

자세한 내용은 Rust Edition Guide를 보세요. 에디션 사이의 차이를 모두 나열하고, cargo fix로 코드를 새 에디션으로 자동으로 고치는 방법을 설명하는 완전한 책입니다.

에디션 마이그레이션

컴파일러를 올리는 일과 에디션을 바꾸는 일은 한 번의 변경에 섞지 않는 것이 좋습니다. 아래 그림은 두 일을 나누어 진행하는 흐름을 보여 줍니다.

먼저 지금의 기준을 기록합니다. rustc --version, 크레이트별 edition과 rust-version, 작업공간의 해석기, Cargo.lock, rustfmt의 스타일, CI의 대상과 기능, 테스트 결과를 남겨 둡니다. 그다음 어느 축을 바꿀지 정합니다. 컴파일러만 올리는 경로에서는 툴체인과 CI 이미지만 바꾸고, 크레이트의 에디션과 해석기, 스타일은 그대로 두어 컴파일러의 진단, 코드 생성, 대상 지원의 변화만 따로 봅니다. Rust 2024로 옮기는 경로는 rustc와 Cargo 1.85 이상을 전제로 합니다. 의존성 갱신은 따로 검토하고, 패키지, 기능, 대상마다 cargo fix --edition을 실행해 결과를 직접 확인한 뒤, Cargo.toml의 edition과 해석기, Cargo.lock, 매크로, 문서 테스트, 포맷의 차이를 나누어 검토합니다. 두 경로 모두 대상과 기능, 에디션이 섞인 구성까지 빌드하고 테스트하고 CI로 검증한 뒤에야 팀의 기준으로 삼습니다.

에디션을 옮기는 명령은 다음과 같습니다. 이 명령은 지금의 에디션에서 실행해, 다음 에디션에서 바뀌는 부분을 고칩니다.

cargo fix --edition

cargo fix --edition은 Cargo.toml의 edition 값을 바꾸지 않으므로, 고친 코드를 확인한 뒤 edition = "2024"처럼 직접 바꾸고 다시 빌드하고 테스트합니다. 선택적인 기능이나 플랫폼별 코드가 있다면 --all-features와 필요한 --target을 조합해 따로 실행합니다. 이 명령은 활성화한 기능과 지금 플랫폼의 cfg에 들어간 코드만 고치기 때문입니다.

정리

• 툴체인의 버전은 컴파일러 릴리스를, 크레이트의 에디션은 그 크레이트의 소스를 해석하는 규칙을 고르며, 둘은 따로 정합니다.
• 러스트는 대략 3년마다 에디션을 내며, 지금은 2015, 2018, 2021, 2024가 있고, Cargo.toml에 edition이 없으면 2015로 봅니다.
• 컴파일러는 자신보다 먼저 나온 모든 에디션을 지원하며, 에디션이 다른 크레이트들도 함께 링크해 쓸 수 있습니다.
• 에디션에는 새 키워드 같은 호환되지 않는 변경이 들어 있을 수 있지만, 고르지 않는 한 컴파일러를 올려도 코드는 계속 컴파일됩니다.
• 에디션을 옮길 때는 기준을 기록하고, cargo fix --edition을 실행한 뒤 edition 값을 직접 바꾸고, 해석기와 포맷의 차이까지 검증합니다.

연습 문제

1. 무엇이 바뀔까

Cargo.toml에 edition = "2021"인 프로젝트에서 (가) rustup으로 컴파일러를 1.80에서 1.99로 올렸다. (나) edition을 "2024"로 바꿨다. 각각의 경우 gen을 변수 이름으로 쓰는 코드는 어떻게 되나요?

2. 섞어 쓸 수 있을까

내 프로젝트는 Rust 2024 에디션이고, 의존하는 크레이트 하나는 Rust 2018 에디션입니다. 그 크레이트를 쓰려면 그 크레이트도 2024로 옮겨야 하나요?

다음 부록 F - 추가 학습 자료에서는 이 교재 다음에 볼 만한 공식 문서와 자료를 정리합니다.