#[cfg(feature = "ssr")]로 서버 전용 모듈을 감싸고, --all-features는 쓰지 않습니다. 두 빌드가 서로의 의존성을 끌고 들어오면 WASM 크기가 먼저 알려 줍니다.

같은 crate 안에서 빌드 경계 정하기#

페이지를 서버에서 그리는 코드와 브라우저에서 연결하는 코드를 한 crate에 두더라도, 서버 전용 의존성은 브라우저 빌드에 들어가면 안 됩니다. 모듈을 나누는 것과 빌드에서 제외하는 것을 함께 확인합니다.

모듈 경계 예 — App import는 생략
src/lib.rs
#[cfg(feature = "ssr")]pub mod server;​#[cfg(feature = "hydrate")]pub fn hydrate() {    leptos::mount::hydrate_body(App);}

검사는 두 번 따로 실행하기#

UI 카탈로그를 포함한 이 저장소의 검사 명령
Shell
cargo check --no-default-features --features ssr,dev-uicargo check --lib --target wasm32-unknown-unknown --no-default-features --features hydrate,dev-ui

dev-ui 카탈로그를 확인할 때는 서버와 브라우저 양쪽에 같은 기능을 켭니다. 운영 빌드에서는 이를 생략합니다. Cargo feature 자체는 일반적으로 더해지는 기능이므로, 이 프로젝트의 빌드 모드 규칙을 별도로 지켜야 합니다.

참고 자료

  1. The Rust Project. (2026 열람). Cargo Features