라이프스타일
Sass와 SCSS 사용법: 변수, 모듈과 컴파일 과정
Sass는 공통 스타일을 정리하는 데 도움이 되지만, 브라우저는 여전히 컴파일된 CSS를 사용합니다. 이 글은 자체 제작한 보드게임 행사 사이트를 예로 들어 SCSS와 들여쓰기 문법, Sass 변수와 CSS 사용자 지정 속성을 구분하고 진입 파일, @use, @forward, 변경 감시 컴파일과 출력 검수를 설명합니다. 작업 단계, 비교표, 자체 제작 도해와 함께 Node Sass 유지보수 종료, 기존 @import 마이그레이션, 소스 맵 주의사항을 정리해 덮어쓰기되는 출력 파일만 수정하는 일을 방지합니다.
읽는 데 약 9분

목차
웹사이트에 행사 카드, 장소 정보, 신청 버튼이 늘어나면 공통 색상과 간격이 여러 파일에 흩어질 수 있습니다. Sass는 이런 설정과 재사용 가능한 규칙을 모듈로 정리할 수 있지만, 컴파일 단계가 추가되므로 소스 파일이 어디에 있고 무엇이 CSS 생성을 담당하는지 알아야 합니다.
아래 보드게임 행사 사이트의 파일명과 스타일 예시는 모두 자체 제작했으며, 2026년 9월 14일에 확인한 Sass 공식 문서를 바탕으로 정리했습니다. 이 글은 작업 흐름 튜토리얼로, 독자를 대신해 패키지를 설치하거나 기존 프로젝트를 수정하지 않았으며 실제 컴파일 테스트를 완료했다고 주장하지도 않습니다.
Sass는 도구, SCSS는 그 문법 중 하나
Sass에는 두 가지 주요 문법이 있습니다. .scss는 중괄호와 세미콜론을 사용해 일반 CSS와 더 비슷하고, .sass는 들여쓰기와 줄바꿈으로 내용을 구성합니다. 둘 다 Sass 컴파일러를 통해 웹사이트에서 사용할 수 있는 CSS로 변환되며, 확장자만 .css로 바꾼다고 변환이 완료되는 것은 아닙니다.
기본 CSS를 아는 초보자라면 SCSS부터 선택해 새로운 문법까지 동시에 익혀야 하는 부담을 줄일 수 있습니다. 기존 프로젝트를 인계받았다면 먼저 원래 관례를 확인하고, 취향을 통일하려고 모든 파일을 다시 작성할 필요는 없습니다. 브라우저는 여전히 CSS의 선택자, 캐스케이드, 박스 모델에 따라 콘텐츠를 배치하며, Sass가 잘못된 레이아웃 로직을 고쳐 주지는 않습니다.
이제 CSS 자체에도 사용자 지정 속성과 기본 중첩 문법이 있으므로, CSS에는 변수나 중첩 규칙이 전혀 없다는 이유로 Sass의 필요성을 설명할 수는 없습니다. 모듈, 컴파일 시점의 연산, 공통 규칙이 정말 필요한지 먼저 살펴보세요. 스타일이 적은 페이지는 CSS를 직접 관리하는 편이 인계하기 더 쉬울 수도 있습니다.
기존 빌드 방식을 확인한 뒤 컴파일러 추가하기
공식 주요 구현체는 Dart Sass이며 여러 방법으로 설치할 수 있습니다. Node.js 프로젝트에서는 sass 패키지를 접하게 됩니다. Node Sass는 2024년에 유지보수 종료를 발표했으므로, 오래된 튜토리얼의 node-sass를 그대로 새 프로젝트의 출발점으로 삼는 것은 적절하지 않습니다. 먼저 프레임워크와 빌드 도구가 어떤 통합 방식을 지원하는지 확인하세요.
프로젝트에 이미 Sass 의존 패키지와 컴파일 명령이 있다면 기존 진입 파일과 출력 위치를 사용해, 별도의 컴파일러가 같은 CSS를 덮어쓰는 일을 방지하세요. 도구를 추가할 때는 패키지와 잠금 파일을 기록해 협업자가 동일한 버전을 사용할 수 있도록 하세요. 프로젝트 설명 없이 특정 컴퓨터에 전역 설치된 도구에만 의존하지 마세요.
설치가 올바르게 완료되어 sass 명령을 사용할 수 있는 실습 환경에서는 sass styles/game-night.scss public/game-night.css로 진입 파일을 지정한 출력 파일로 변환할 수 있습니다. 파일명은 이 글의 예시이므로, 실행 전에 소스를 만들고 대상 경로가 직접 작성한 파일을 덮어쓰지 않는지 확인하세요. 웹사이트는 SCSS를 직접 불러오는 대신 public에서 외부에 제공하는 CSS URL을 불러와야 합니다.
컴파일 시점의 변수와 브라우저의 변수 구분하기
Sass 변수는 $로 시작합니다. 예를 들어 $card-gap: 18px;로 정의한 뒤 선언에서 gap: $card-gap;로 사용합니다. 컴파일 후 변수를 사용한 위치는 해당 값으로 바뀌며, 브라우저에는 JavaScript로 실시간 수정할 수 있는 Sass 변수가 남지 않습니다. 따라서 이를 수정해 웹사이트에 반영하려면 보통 CSS를 다시 생성해야 합니다.
CSS 사용자 지정 속성은 --card-gap 같은 이름을 사용하고 var(--card-gap)으로 값을 가져오며, CSS에 남아 브라우저의 계산과 상속에 참여합니다. 테마나 특정 컨테이너에 따라 실행 중 값을 바꾸고 싶다면 사용자 지정 속성을 고려할 수 있습니다. 여러 스타일 파일을 생성할 때 사용하는 고정 설정이라면 Sass 변수도 편리합니다.
둘을 함께 사용할 수 있지만, 값이 어느 단계에서 결정되는지 명확히 해야 합니다. 보드게임 행사 페이지에서는 컴파일 시점의 기본 간격과 브라우저가 테마에 따라 조정하는 색상을 나눠 관리할 수 있습니다. 둘 다 변수라고 부른다는 이유로, Sass 소스를 수정하면 다시 컴파일하거나 리소스를 갱신하지 않아도 이미 열린 웹페이지가 자동으로 바뀔 것이라고 기대하지 마세요.
@use로 소스를 관리하고 @forward로 공개 진입점 정리하기
공통 설정을 styles/_tokens.scss에 넣고 styles/game-night.scss의 시작 부분에 @use 'tokens';를 작성할 수 있습니다. 모듈이 $card-gap을 정의했다면 tokens.$card-gap으로 가져와 값의 출처를 알 수 있게 합니다. 밑줄로 시작하는 partial 파일은 다른 파일에서 불러오는 조각이며, 보통 독립적인 출력 진입 파일로 사용하지 않습니다.
@use로 불러온 멤버는 해당 스타일시트에서만 보이므로, 다른 모듈에서 같은 설정이 필요하다면 직접 불러와야 합니다. 동일한 모듈이 생성하는 스타일은 한 번의 컴파일에서 한 번만 포함됩니다. 그렇다고 모든 진입 파일에서 생성한 CSS를 웹사이트에서 함께 사용할 때 중복 규칙이 절대로 생기지 않는다는 뜻은 아니므로, 실제 출력과 로딩 방식을 확인해야 합니다.
모듈이 많아지면 @forward로 공개 변수, 함수, mixin을 하나의 외부 진입점으로 정리할 수 있습니다. 전달한 멤버를 현재 파일에서 자동으로 사용할 수 있게 해 주지는 않으므로, 사용하려면 여전히 @use를 추가해야 합니다. 초기에는 명확한 네임스페이스를 유지하고, 서둘러 as *로 모든 이름을 한데 풀어 놓지 마세요.
변경 감시는 수정을 돕지만 출력 검수는 여전히 필요
실습할 때 sass --watch styles/game-night.scss public/game-night.css를 사용하면 소스가 바뀐 뒤 다시 컴파일할 수 있습니다. 이 명령은 파일 갱신을 담당하며, 웹사이트 서버를 시작하거나 브라우저를 새로고침한다는 뜻은 아닙니다. 공통 조각 파일을 수정한 뒤에는 감시 범위에 포함되어 있고 터미널에 오류가 없는지 확인하세요.
Dart Sass의 expanded 출력은 읽기 편합니다. --style=compressed는 불필요한 문자를 줄여 압축이 필요한 출력 과정에 적합하지만, 스타일의 최적화나 호환성을 보장하지는 않습니다. 지나치게 깊게 중첩된 선택자나 반복해서 많이 펼쳐지는 mixin도 관리하기 어려운 CSS를 생성할 수 있으므로 출력을 직접 확인해야 합니다.
명령줄에서는 기본적으로 소스 맵을 생성해 컴파일된 규칙을 소스와 대응시키는 데 도움을 줍니다. 실제 서비스에서 어떤 대응 정보를 공개할지는 프로젝트에 따라 결정해야 합니다. 대응 파일을 생성하지 않아야 한다면 --no-source-map을 확인하세요. 스타일, 주석, 내장된 소스에 기밀 정보를 넣지 말고, 파일만 삭제한 채 유효하지 않은 대응 링크를 남겨 두지도 마세요.
- 프로젝트의 기존 Sass 버전, 명령, 진입 파일, CSS 로딩 위치를 확인합니다.
- 작은 SCSS 진입 파일과 공통 설정을 만들고 @use로 명시적으로 참조합니다.
- 한 번 컴파일한 뒤 변경 감시를 시작하고, 수정하면 올바른 CSS가 생성되는지 확인합니다.
- 경고, 선택자, 실제 페이지, 인계 파일을 확인하고 마이그레이션이 필요한 항목을 기록합니다.
기존 프로젝트에서는 경고 문구만 없애지 않기
Sass의 @import와 일부 전역 내장 함수는 Dart Sass 1.80.0부터 사용 중단 예정으로 표시되었습니다. 이는 브라우저 기본 CSS의 @import와는 다른 문제이며, 확인일 기준 모든 기존 Sass 소스를 전혀 컴파일할 수 없다는 뜻도 아닙니다. 실제 버전과 의존 패키지에 따라 마이그레이션을 계획해야 합니다.
공식 도구인 Sass migrator가 모듈로의 전환을 돕지만, 소스 순서, 네임스페이스, 설정 방식, 출력 차이는 여전히 대조해야 합니다. 먼저 복원할 수 있는 버전을 보존하고 복사본이나 별도 브랜치에서 작업하세요. 문제가 외부 패키지에서 비롯됐다면 업데이트 상태를 확인하세요. 경고 표시를 끄는 것은 호환성 문제를 해결한 것과 같지 않습니다.
검수할 때는 컴파일 성공뿐 아니라 웹사이트가 새 CSS를 불러오는지, 긴 텍스트와 좁은 화면의 표시가 나빠지지 않았는지, 공통 설정이 예정된 컴포넌트에만 영향을 주는지도 확인해야 합니다. 평소 수정은 SCSS 소스에서 하세요. 생성 파일을 직접 수정하면 다음 컴파일 때 수정 내용이 전부 사라질 수 있습니다. 인계 자료에는 소스, 의존 패키지 버전, 빌드 명령, 출력 위치를 포함해 다른 사람도 같은 결과를 다시 생성할 수 있도록 해야 합니다.
자세한 설명 보기
네 장의 카드가 SCSS 소스, 모듈 로딩, Dart Sass 컴파일, CSS 페이지 검사를 설명하며, 평소 수정은 소스에서 해야 함을 상기시킵니다.
| 항목 | 이뤄지는 단계 | 확인할 사항 |
|---|---|---|
| .scss/.sass | 소스 작성 | 같은 Sass에 속하는 서로 다른 문법 |
| Sass $변수 | 컴파일 시점 | 수정 후 다시 생성해야 함 |
| CSS --사용자 지정 속성 | 브라우저 계산 시점 | var() 사용과 적용 범위 |
| @use | Sass 모듈 로딩 | 명확한 네임스페이스와 출처 |
| @forward | 모듈의 공개 진입점 정리 | 현재 파일에서 자동으로 사용할 수는 없음 |
| CSS와 소스 맵 | 컴파일 출력과 디버깅 | 웹사이트 URL과 공개 정보 |
먼저 CSS 선택자와 박스 모델 이해하기CSS 입문: 선택자, 박스 모델과 레이아웃 구성CSS를 처음 배울 때는 스타일이 적용되지 않거나, 카드가 예상보다 넓어지거나, 글이 길어지면 겹치는 문제가 흔합니다. 이 글은 직접 설계한 워크숍 행사 카드를 예로 들어 선택자와 선언을 읽는 법부터 시작해 content, padding, border, margin과 box-sizing의 관계를 설명하고, 일반 흐름, Flexbox와 Grid의 활용 방향을 정리합니다. 너비 계산, 실습 단계, 비교표와 직접 그린 도해를 통해 브라우저에서 확인할 수 있는 레이아웃 연습을 돕습니다.전체 글 읽기
반응형 화면의 콘텐츠 배치 확인하기반응형과 적응형 웹사이트: 모바일 읽기에 맞춘 레이아웃휴대폰에서 웹사이트가 열린다고 작은 화면에서 읽기에도 적합한 것은 아니다. 이 글은 자체 제작한 커뮤니티 강좌 신청 페이지를 예로 들어 반응형과 적응형 레이아웃의 차이, 콘텐츠에 따른 중단점 선택, 너비별 이미지·폼·내비게이션 배치를 설명한다. 작업 단계, 비교표, 자체 제작 도해와 함께 확대·축소, 가로·세로 방향, 키보드, 실제 기기 검수의 핵심을 정리해 독자가 디자이너나 개발자와 여러 기기에서 실제로 사용할 수 있는 페이지를 논의하도록 돕는다.전체 글 읽기
웹사이트 설계부터 인계까지의 과정 정리하기웹 디자인 시작하기: 요구사항, 콘텐츠, 검수의 전체 순서처음 웹사이트를 만들 때 막히는 이유는 배색보다 요구사항, 콘텐츠, 검수 방법을 명확히 정하지 않은 데 있는 경우가 많다. 이 글은 직접 구상한 동네 수리 작업실 웹사이트를 예로 들어 사용자 인터뷰, 자료 정리, 프로토타입 제작, 개발과 인계 계획까지 각 단계에서 남겨야 할 결과물을 설명한다. 절차, 비교표, 학습 자료, 자체 제작 도해를 제공해 직접 제작하거나 디자인을 의뢰하는 독자가 웹사이트의 완성 여부를 실제로 확인할 수 있는 작업으로 구체화하도록 돕는다.전체 글 읽기
이 정리가 도움이 되셨나요? 필요한 분께 공유해 보세요
같은 주제의 글
라이프스타일
www, 하위 도메인과 하위 디렉터리: 웹사이트 URL 구조 결정하기
웹사이트에 www를 붙일지, 블로그를 blog.example.com과 example.com/blog/ 중 어디에 둘지는 플랫폼 지원과 유지관리 방식을 함께 살펴 결정해야 합니다. 이 글에서는 URL의 호스트 이름과 경로를 먼저 구분한 뒤, 하위 도메인과 하위 디렉터리의 콘텐츠 분담, DNS 설정, HTTPS 인증서, URL 일관성을 비교합니다. 자체 제작한 의사결정표와 공개 전 점검 절차를 통해 대만의 소규모 웹사이트가 사용·관리·인수인계하기 쉬운 URL 구조를 갖추도록 돕습니다.
라이프스타일
웹 디자인 업체를 찾기 전에: 요구사항 정의서, 견적과 납품 목록
웹 디자인 업체를 찾기 전에 사이트의 대상 이용자, 주요 동작과 납품 내용을 명확히 적어야 견적을 비교할 수 있습니다. 이 글은 소규모 스튜디오의 웹사이트 요구사항을 예로 들어 페이지와 템플릿 수, 콘텐츠 담당, 기능 명세, 모바일 및 접근성 검수, 계정과 원본 파일 인계를 정리하고, 사이트 공개 후 유지관리를 어떻게 합의할지 설명합니다. 바로 수정해 쓸 수 있는 요구사항 목록으로 추가 비용과 소통의 어긋남을 줄이도록 돕습니다. 업체 추천 목록은 제공하지 않습니다.
라이프스타일
웹 디자인 시작하기: 요구사항, 콘텐츠, 검수의 전체 순서
처음 웹사이트를 만들 때 막히는 이유는 배색보다 요구사항, 콘텐츠, 검수 방법을 명확히 정하지 않은 데 있는 경우가 많다. 이 글은 직접 구상한 동네 수리 작업실 웹사이트를 예로 들어 사용자 인터뷰, 자료 정리, 프로토타입 제작, 개발과 인계 계획까지 각 단계에서 남겨야 할 결과물을 설명한다. 절차, 비교표, 학습 자료, 자체 제작 도해를 제공해 직접 제작하거나 디자인을 의뢰하는 독자가 웹사이트의 완성 여부를 실제로 확인할 수 있는 작업으로 구체화하도록 돕는다.
라이프스타일
웹사이트 캐시와 CDN: 업데이트가 보이지 않을 때 어느 계층을 비워야 할까
웹사이트를 업데이트했는데도 휴대전화에서 이전 콘텐츠가 보인다면, 여러 위치에 캐시가 남아 있을 수 있다. 이 글은 대만 스튜디오의 영업시간 변경을 예로 들어 브라우저, WordPress/호스팅, CDN의 역할을 정리하고, 캐시 응답, 만료 시간, 특정 리소스의 캐시 삭제를 판단하는 방법을 설명한다. 작업 순서, 비교표, 자체 제작 도해를 통해 웹사이트 관리자가 이전 버전의 출처를 찾고 회원 및 쇼핑 기능의 정확성도 챙길 수 있도록 돕는다.
출처
- Sass: 기초확인일:
- Sass: 설치 방법확인일:
- Sass: 변수확인일:
- Sass: @use확인일:
- Sass: @forward확인일:
- Sass: Dart Sass CLI확인일:
- Sass: @import와 전역 함수의 사용 중단 예정확인일:
- Sass: Node Sass 유지보수 종료확인일:
- MDN: CSS 중첩확인일:
위에 기재된 참고 자료와 확인일 기준 정보를 바탕으로 정리했습니다. 요금, 시간표, 기능, 이용 약관은 바뀔 수 있으므로 여행, 예약 또는 구매 전에 해당 공식 사이트에서 최신 정보를 확인해 주세요.