Rust 1.100 업그레이드: 타입 오류와 Cargo CI 변경 점검

Rust 1.100의 타입 호환성 변경을 점검하고 Cargo 의존성 쿨다운, 린트, 빌드 산출물 탐색 변경을 CI에 반영한다.

2026-11-21

에디션을 유지해도 업그레이드 검증은 필요하다

Rust 1.100에서는 never 타입 fallback이 모든 에디션에서 !로 바뀐다. 에디션 변경을 하지 않는다는 이유만으로 타입 추론 관련 호환성 점검을 생략할 수 없다. Infallible은 !의 타입 별칭이 되고, box 패턴은 문법적으로 허용되지 않는다.

이 글의 기준은 **Rust 1.100.0 (2026-11-12)**의 공식 릴리스 노트다. 업그레이드 작업은 새 API 도입보다 기존 코드와 자동화가 받는 영향을 먼저 확인하는 순서로 잡는다. 컴파일러가 받아들이는 코드뿐 아니라 Cargo가 선택하는 의존성과 CI가 빌드 결과를 찾는 방식도 변경 범위에 들어간다.

검증 대상을 소스 코드, 의존성 선택, CI 도구로 나누면 컴파일 성공만으로 놓칠 수 있는 경계를 드러낼 수 있다.

⤢✕Rust 1.100 업그레이드 검증소스 코드의존성 선택CI 도구타입 추론과 문법의존성 쿨다운과 lockfileCargo 린트와 산출물 탐색

실제 작업에서도 이 구분을 유지한다. 소스 코드 검증에서는 새 컴파일 오류의 원인을 분류하고, 의존성 검증에서는 쿨다운과 lockfile의 관계를 확인한다. CI 검증에서는 린트 설정과 빌드 디렉토리를 직접 읽는 도구를 따로 확인한다.

never 타입 안정화와 기존 코드의 오류를 함께 본다

never 타입 !의 안정화는 새로 사용할 수 있는 기능인 동시에 기존 타입 추론을 다시 확인해야 하는 변경이다. 특히 fallback 변경과 Infallible 별칭화는 같은 릴리스에 포함돼 있다. 업그레이드 뒤 관련 오류가 발생하면 어느 변경에 해당하는지 나누어 읽어야 한다.

변경 점검할 코드 확인하거나 적용할 일
never 타입 fallback이 모든 에디션에서 !로 변경 타입 추론 결과에 의존하는 코드 새 오류가 발생한 위치에서 의도한 타입과 진단을 대조한다
Infallible이 !의 타입 별칭으로 변경 Infallible을 사용하는 타입·트레이트 구현 별칭화를 반영해 해당 구현의 컴파일 결과를 확인한다
box 패턴 문법 금지 패턴 위치에 box를 쓰는 코드 해당 문법을 제거하고 의도한 동작을 검증한다
if let을 사용하는 클로저의 캡처 정밀화 해당 클로저와 캡처되는 변수 새 오류가 생기면 캡처 관련 진단을 확인한다
더 많은 위치에서 trait object의 dyn 호환성 검사 trait object를 사용하는 코드 새로 드러난 호환성 오류를 확인한다

box 패턴 금지와 Box API 변경은 구분해야 한다. 릴리스 노트가 문법적으로 금지한다고 밝힌 대상은 패턴의 box 문법이다. 한편 Box에는 커스텀 allocator 관련 API 안정화와 일부 구현의 일반화가 별도로 포함돼 있다.

따라서 Box 주변에서 오류가 났다고 모두 패턴 문제로 처리하지 않는다. 문법 오류인지, 타입 추론 오류인지부터 나누고 해당 변경을 확인한다. 자료에는 구체적인 실패 코드나 일괄 변환법이 없으므로, 프로젝트의 실제 진단을 기준으로 수정 범위를 정한다.

커스텀 allocator 도입과 호환성 수정을 분리한다

이번 릴리스는 커스텀 allocator를 안정화한다. 안정화 목록에는 std::alloc::Allocator, Global, System과 함께 Box·Vec에서 allocator를 지정하거나 조회하는 API가 포함돼 있다.

관련 API를 검토할 때는 생성, 원시 표현과의 변환, allocator 조회를 나누어 확인한다. 다음은 릴리스 노트에 명시된 API 일부다.

std::alloc::Allocator
std::alloc::Global
std::alloc::System

Box::new_in
Box::from_raw_in
Box::into_raw_with_allocator
Box::allocator

Vec::new_in
Vec::with_capacity_in
Vec::from_raw_parts_in
Vec::into_raw_parts_with_allocator
Vec::allocator

기존 프로젝트를 올리는 작업이라면 새 API 적용과 호환성 수정을 별도 변경으로 다루는 편이 원인을 확인하기 쉽다. 릴리스 노트는 일부 Box 구현이 임의의 allocator를 지원하도록 일반화되면서 새 타입 추론 오류가 생길 수 있다고 명시한다. 커스텀 allocator를 새로 도입하지 않는 코드에서도 이 호환성 항목을 확인할 필요가 있다.

업그레이드 직후에는 기존 코드가 컴파일되는지 먼저 검증한다. allocator 관련 새 API를 적용하려는 경우에는 그다음 변경으로 분리하고, 해당 API가 필요한 지점과 타입을 검토한다. 안정화 사실만으로 프로젝트의 할당 성능이나 메모리 사용량이 개선된다고 판단할 근거는 이 자료에 없다.

의존성 쿨다운은 lockfile 예외까지 포함해 검증한다

Cargo의 minimum publish age, 즉 의존성 쿨다운은 관련 설정을 했을 때 resolver가 최근 발행된 버전을 제외하는 기능이다. 설정한 기간보다 최근에 발행된 버전은 선택 대상에서 빠지지만, 이미 Cargo.lock에 들어 있는 버전은 예외다.

이 예외는 공급망 정책을 CI에 반영할 때 직접적인 의미가 있다. 쿨다운을 설정했다는 사실만으로 lockfile에 기록된 최근 발행 버전까지 제외된다고 해석하면 안 된다. 설정 적용 여부와 lockfile 내용을 함께 확인해야 실제 의존성 선택을 설명할 수 있다.

다음 분기는 쿨다운 규칙만을 나타낸다. “이 규칙으로 제외하지 않음”은 최종 선택을 보장한다는 뜻이 아니다.

⤢✕아니요예예아니요예아니요의존성 버전쿨다운 설정 적용이 규칙으로 제외하지 않음Cargo.lock에 이미 기록설정한 기간보다 최근 발행resolver가 제외

프로젝트에 적용할 때는 먼저 의존성 선택 정책을 분명히 한다. 새로 선택하는 버전에 발행 후 대기 기간을 두려는 것인지, 이미 기록된 lockfile도 별도로 검토하려는 것인지 구분한다. 후자의 검토를 쿨다운 설정 하나로 대신할 수는 없다.

제공된 릴리스 노트에는 구체적인 설정 키, 기간 표기법, 권장 대기 기간이 없다. 따라서 설정값을 임의로 복사해 넣기보다, 도입 시점에 릴리스 노트가 연결한 publish age 문서에서 구문을 확인하고 프로젝트 정책에 맞게 정한다.

Cargo 린트와 설치용 lockfile을 CI에 반영한다

Cargo에는 자체 린트 체계가 도입됐다. 일부 Cargo 경고를 [lints.cargo] 테이블에서 제어할 수 있고, 미사용 의존성을 검사하는 cargo::unused_dependencies 린트가 추가됐다.

CI에서는 Cargo 경고를 수집하거나 판정하는 부분을 확인한다. 릴리스 노트의 표현은 일부 경고가 린트로 바뀐다는 것이므로, 모든 Cargo 경고를 같은 방식으로 제어할 수 있다고 전제하면 안 된다. 미사용 의존성 검사를 도입할 때도 검사 대상과 실제 진단을 확인한 뒤 의존성 정리 범위를 정한다. 제공 자료에는 린트의 기본 수준이나 설정 예시가 없으므로 여기서 설정 파일을 만들어 제시하지는 않는다.

cargo install에는 별도의 동작 변경이 있다. 이제 .crate tarball 안에 기존 lockfile이 있으면 기본으로 사용하며, cargo install의 --locked는 no-op이 된다.

CI에서 확인할 대상 Rust 1.100의 변경 검증할 내용
Cargo 경고 처리 일부 경고를 [lints.cargo]에서 제어 기존 경고 처리와 새 린트 설정이 의도대로 맞물리는지 확인한다
미사용 의존성 검사 cargo::unused_dependencies 추가 프로젝트에서 발생하는 진단을 확인한다
설치하는 .crate 내부의 기존 lockfile을 기본 사용 설치 검증에 해당 lockfile의 존재와 내용을 포함한다
cargo install의 --locked no-op으로 변경 플래그만으로 설치 동작 차이를 설명하는 스크립트 주석·문서를 수정한다

의존성 쿨다운과 설치용 lockfile 사용은 서로 다른 변경이다. 전자는 resolver가 최근 발행 버전을 제외하는 조건이고, 후자는 cargo install이 .crate에 포함된 기존 lockfile을 기본으로 사용하는 동작이다. CI 검증에서도 각각의 적용 지점을 확인한다.

빌드 디렉토리 경로 대신 Cargo 메시지로 산출물을 찾는다

Cargo는 중간 빌드 산출물에 새 디렉토리 레이아웃을 사용한다. 릴리스 노트는 빌드 디렉토리를 검사하는 도구에 대해, 디렉토리 배치에 의존하는 대신 Cargo의 JSON 메시지로 빌드 산출물을 찾는 방식을 검토하도록 안내한다. 디렉토리 레이아웃은 안정적인 인터페이스가 아니며 다시 바뀔 수 있다고도 명시한다.

따라서 소스가 컴파일돼도 CI 검증은 남아 있을 수 있다. 빌드 디렉토리 경로를 직접 조합하거나 특정 하위 디렉토리를 탐색하는 도구가 있다면, 새 레이아웃에서 필요한 산출물을 계속 찾는지 확인한다. 경로 수정이 필요해졌다면 새 배치를 다시 고정하기 전에 JSON 메시지를 통한 탐색으로 바꿀 수 있는지 검토한다.

산출물 탐색의 변경 방향은 도구가 의존하는 경계를 기준으로 비교할 수 있다.

⤢✕ CI의 빌드 산출물 탐색 경계 공통 비교 축 도구가 읽는 정보 산출물 위치 확인 방식 업그레이드 시 점검 대상 디렉토리 배치에 의존 중간 빌드 산출물 디렉토리 경로 직접 조합 또는 하위 디렉토리 탐색 새 레이아웃에서 산출물을 찾는지 확인 VS Cargo JSON 메시지 활용 Cargo의 JSON 메시지 메시지로 빌드 산출물 위치 확인 메시지를 읽는 도구의 동작 확인 디렉토리 레이아웃 안정적인 인터페이스가 아니며 다시 바뀔 수 있음

이 변경은 새 디렉토리 구조를 외우는 작업보다 도구의 입력을 바꾸는 작업에 가깝다. 릴리스 노트에는 새 레이아웃의 구체적인 경로나 JSON 메시지 예시가 없으므로, 여기서는 경로와 파서를 임의로 제시하지 않는다. 구현 시에는 Cargo JSON 메시지 문서를 기준으로 필요한 산출물을 식별한다.

타깃별 호환성까지 확인하고 업그레이드를 닫는다

프로젝트가 특정 타깃을 지원한다면 일반적인 타입 오류 수정 뒤에도 확인할 항목이 남는다. 이번 릴리스에는 타깃 지원 수준과 ABI 관련 변경이 함께 포함돼 있다.

해당 환경 릴리스 노트의 변경 업그레이드 확인점
i686-pc-windows-gnu host tools가 없는 Tier 2 타깃으로 변경 해당 타깃을 사용하는 빌드 환경 구성을 검토한다
ARM 타깃 ABI를 바꾸는 -Ctarget-feature·-Ctarget-cpu 값이 hard error로 거부됨 기존 컴파일 옵션의 수용 여부를 확인한다
x86 softfloat 타깃 SSE/AVX 활성화를 시도하면 오류 발생 타깃과 활성화 옵션의 조합을 확인한다
일부 ARMv7-A hardfloat 타깃 잘못 포함됐던 기본 d32 feature 수정 수정으로 인한 빌드 실패인지 확인한다

ARMv7-A hardfloat 항목에는 적용 범위를 좁혀 읽어야 하는 복구 안내가 있다. 릴리스 노트에 따르면 1.94부터 1.100까지 일부 타깃은 잘못 포함된 d32 feature 때문에 최소 VFPv3-D32 FPU를 요구했다. 이 오류를 바로잡으면서 생긴 실패에는 다음 옵션을 Rust에 전달하는 방법이 제시돼 있다.

-Ctarget-feature=+d32

이 옵션은 해당 수정으로 발생한 실패에 대한 안내다. 타깃을 확인하지 않고 공통 CI 옵션에 추가할 근거로 사용하지 않는다.

업그레이드 완료 조건은 프로젝트가 사용하는 경계에 맞춰 잡는다. 기존 코드가 새 타입·문법 규칙에서 컴파일되고, 쿨다운과 lockfile에 따른 의존성 선택이 의도에 맞으며, CI 도구가 린트와 산출물을 계속 처리하는지 확인한다. 해당 타깃의 컴파일 옵션까지 검증했다면 Rust 1.100의 호환성 변경과 운영 자동화 변경을 함께 점검한 상태로 업그레이드를 마칠 수 있다.

RustCargoCI의존성 관리업그레이드