콘텐츠로 이동

next.config.js 옵션: useLightningcss

next.config.js 옵션: useLightningcss | Next.js

섹션 제목: “next.config.js 옵션: useLightningcss | Next.js”

Source URL: https://nextjs.org/docs/pages/api-reference/config/next-config-js/useLightningcss

이 기능은 현재 실험적이며 변경될 수 있으므로 프로덕션 환경에서는 권장되지 않습니다. 사용해 보고 GitHub에서 피드백을 공유해 주세요.

마지막 업데이트 2026년 2월 20일

webpack과 함께 Lightning CSS를 사용할 수 있는 실험적 지원입니다. Lightning CSS는 Rust로 작성된 빠른 CSS 변환기이자 최소화 도구입니다.

이 옵션을 설정하지 않으면 webpack 기반 Next.js는 기본적으로 postcss-preset-env를 포함한 PostCSS를 사용합니다.

Next 14.2부터 Turbopack은 기본적으로 Lightning CSS를 사용합니다. 이 구성 옵션은 Turbopack에 아무런 영향을 주지 않습니다. Turbopack은 항상 Lightning CSS를 사용합니다.

next.config.ts

JavaScript TypeScript

import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
experimental: {
useLightningcss: false, // default, ignored on Turbopack
},
}
export default nextConfig
VersionChanges
15.1.0Turbopack에서 useSwcCss 지원이 제거되었습니다.
14.2.0Turbopack의 기본 CSS 프로세서가 @swc/css에서 Lightning CSS로 변경되었습니다. useLightningcss는 Turbopack에서 무시되며, 레거시 옵션 experimental.turbo.useSwcCss가 추가되었습니다.

보내기