---
title: "워드프레스에서 미디어 쿼리가 작동하지 않을 때 해결 방법(간단 가이드)"
description: "'워드프레스에서 미디어 쿼리가 작동하지 않습니다' 오류를 해결하는 것은 원인을 파악하면 간단합니다. 자세한 내용은 여기를 참조하세요."
url: https://seahawkmedia.com/ko/%EC%9C%A0%EC%A7%80%EB%B3%B4%EC%88%98/%EC%9B%8C%EB%93%9C%ED%94%84%EB%A0%88%EC%8A%A4%EC%97%90%EC%84%9C-%EB%AF%B8%EB%94%94%EC%96%B4-%EC%BF%BC%EB%A6%AC%EA%B0%80-%EC%9E%91%EB%8F%99%ED%95%98%EC%A7%80-%EC%95%8A%EC%8A%B5%EB%8B%88%EB%8B%A4/
language: ko
---

[Home](https://seahawkmedia.com/ko/) / [유지보수](https://seahawkmedia.com/ko/%EC%9C%A0%EC%A7%80%EB%B3%B4%EC%88%98/) /워드프레스에서 미디어 쿼리가 작동하지 않을 때 해결 방법은 무엇인가요?

Guide

# 워드프레스에서 미디어 쿼리가 작동하지 않을 때 해결 방법은 무엇인가요?

By [Akshay Kumar](https://seahawkmedia.com/author/akshay-kumar/) May 15, 2025 Updated February 3, 2026 6 min read

[WordPress](https://seahawkmedia.com/wordpress/) [For businesses](https://seahawkmedia.com/small-business/)

Read in [English](https://seahawkmedia.com/maintenance/media-query-not-working-in-wordpress/) [العربية](https://seahawkmedia.com/ar/%D8%A7%D9%84%D8%B5%D9%8A%D8%A7%D9%86%D8%A9/%D9%84%D8%A7-%D8%AA%D8%B9%D9%85%D9%84-%D8%A7%D8%B3%D8%AA%D8%B9%D9%84%D8%A7%D9%85%D8%A7%D8%AA-%D8%A7%D9%84%D9%88%D8%B3%D8%A7%D8%A6%D8%B7-%D9%81%D9%8A-%D9%88%D9%88%D8%B1%D8%AF%D8%A8%D8%B1%D9%8A%D8%B3/) [Dansk](https://seahawkmedia.com/da/vedligeholdelse/medieforesporgsel-virker-ikke-i-wordpress/) [Deutsch](https://seahawkmedia.com/de/wartung/media-queries-funktionieren-in-wordpress-nicht/) [Español](https://seahawkmedia.com/es/mantenimiento/las-consultas-de-medios-no-funcionan-en-wordpress/) [Français](https://seahawkmedia.com/fr/maintenance/les-requetes-media-ne-fonctionnent-pas-dans-wordpress/) [Italiano](https://seahawkmedia.com/it/manutenzione/le-media-query-non-funzionano-in-wordpress/) [日本語](https://seahawkmedia.com/ja/%E3%83%A1%E3%83%B3%E3%83%86%E3%83%8A%E3%83%B3%E3%82%B9/wordpress%E3%81%A7%E3%83%A1%E3%83%87%E3%82%A3%E3%82%A2%E3%82%AF%E3%82%A8%E3%83%AA%E3%81%8C%E6%A9%9F%E8%83%BD%E3%81%97%E3%81%AA%E3%81%84/) [Nederlands](https://seahawkmedia.com/nl/onderhoud/mediaquery-werkt-niet-in-wordpress/) [Português](https://seahawkmedia.com/pt/manutencao/a-consulta-de-midia-nao-esta-funcionando-no-wordpress/) [Svenska](https://seahawkmedia.com/sv/underhall/mediafragan-fungerar-inte-i-wordpress/)

반응형 웹 디자인의 핵심 요소 중 하나는 CSS 미디어 쿼리입니다. [워드프레스 개발자는](https://seahawkmedia.com/ko/%EC%84%9C%EB%B9%84%EC%8A%A4/%EC%9B%8C%EB%93%9C%ED%94%84%EB%A0%88%EC%8A%A4-%EA%B0%9C%EB%B0%9C/) 미디어 쿼리 기법을 사용하여 웹사이트가 모든 기기와 화면 크기에서 최적의 상태로 작동하도록 합니다. 만약 이 CSS 기법에 문제가 발생하면 '워드프레스에서 미디어 쿼리가 작동하지 않습니다'라는 오류 메시지가 나타날 수 있습니다.

워드프레스에서 '미디어 쿼리가 작동하지 않습니다' 오류를 해결하는 것은 화면 유형과 크기에 관계없이 모든 사용자가 웹사이트에 접근할 수 있도록 보장하는 데 필수적입니다. 아래에서는 '미디어 쿼리가 작동하지 않습니다' 오류를 해결하는 몇 가지 팁을 제공합니다. 하지만 그 전에 CSS 미디어 쿼리에 대한 간략한 설명을 드리겠습니다.

## CSS 미디어 쿼리란 무엇인가요?

CSS(캐스케이딩 스타일 시트)의 기능 중 하나인 미디어 쿼리는 개발자가 특정 조건에 따라 서로 다른 CSS 규칙 세트를 적용할 수 있도록 해줍니다. 이를 통해 개발자는 기기 종류나 브라우저 화면 크기에 따라 다양한 디자인 레이아웃을 구현할 수 있습니다. 미디어 쿼리는 개별 CSS 파일에서 사용하거나 웹 페이지의 [HTML 코드](https://seahawkmedia.com/glossary/html/).

반응형 웹 디자인을 위한 W3C 권장 표준입니다. 또한 화면 해상도, 브라우저 너비, 기기 종류 등 다양한 환경에 맞춰 콘텐츠가 자동으로 조정되도록 보장합니다.

### CSS 미디어 쿼리 사용법

웹사이트 탐색 시 사용자 경험을 향상시키는 것은 검색 결과에서 웹사이트 순위를 높이는 중요한 요소 중 하나이며, CSS 미디어 쿼리가 바로 이 부분에서 도움을 줄 수 있습니다.

미디어 쿼리는 모든 기기, 화면 크기 및 해상도에서 웹 페이지의 모양을 사용자 지정하는 데 도움이 됩니다. 미디어 쿼리는 모바일, 데스크톱 또는 기타 기기에서 웹 페이지를 볼 때 브라우저가 웹 페이지를 렌더링하는 방법을 알려주는 구체적인 지침을 제공합니다.

CSS 미디어 쿼리를 사용하면 개발자는 별도의 모바일 웹사이트를 만들 필요 없이 모든 기기에서 접근성과 가독성이 뛰어난 웹사이트를 제작할 수 있습니다.

**관련 항목**: 모바일 사이트와 반응형 사이트의 차이점

**다음은 미디어 쿼리의 예입니다**

```
@media 화면 및 (최대 너비: 480px)
```

```
{
```

```
헤더 { 높이: 70px; }
```

```
기사 { 글꼴 크기: 14px; }
```

```css
img { max-width: 480px; }
```

```
}
```

**미디어 쿼리는 다음과 같은 용도로 사용됩니다**

- CSS의 `@media` 및 `@import` 어노테이션을 사용하여 조건부 스타일을 적용합니다.

- 모바일 기기에서 페이지를 세로 모드로 볼 때 사이드바를 사이트 콘텐츠 아래로 이동합니다.

- 특정 미디어를 대상으로 <style>, <source>, and other HTML elements with the media= attribute.

- 기기 화면 크기에 따라 열 너비를 조정합니다.

- 모바일 기기에서 레이아웃을 2단 레이아웃에서 1단 레이아웃으로 변경하는 방법.

### 미디어 쿼리 구문

미디어 쿼리는 다음 네 가지 요소로 구성됩니다. 구문을 이해하면 미디어 쿼리를 올바르게 사용할 수 있습니다.

#### @미디어 규칙

이 요소는 CSS에서 미디어 쿼리를 설정하려는 의도를 선언(명시)하는 데 도움이 됩니다. 공백 없이 `@media`를 입력하세요.

#### 미디어 유형

미디어 유형은 미디어 쿼리가 사용되는 장치의 유형을 나타냅니다. 여기에는 다음과 같은 규칙이 포함됩니다

- **모두**: 모든 기기에 적합하며, 미디어 유형이 지정되지 않은 경우 '모두'가 사용됩니다.

- **음성**: 이 미디어 유형은 화면 낭독기에 적용되거나 화면 낭독기를 위해 만들어졌습니다.

- **인쇄**: 페이지 자료 또는 문서가 인쇄 미리보기 모드인 경우 '인쇄' 용지 유형이 적용됩니다. 이 용지 유형은 프린터에 사용됩니다.

- **화면**: 이 CSS 규칙은 스마트폰, 데스크톱, 태블릿 등 모든 화면에 적용됩니다.

#### 미디어 기능

미디어 기능 요소는 특정 세부 정보를 추가하는 데 사용됩니다. 모든 미디어 기능 표현식은 대괄호 안에 배치됩니다. 예를 들어 `max-width 400px (모바일 기기)`와 같이 사용합니다. 여기서 `max-width` 미디어 기능은 모바일 기기에 적용됩니다.

**기타 미디어 기능 및 그 기능은 다음과 같습니다**

- **너비**: 이는 뷰포트의 너비를 나타냅니다.

- **Max-width**: 브라우저 창의 '최대 너비'를 정의합니다.

- **높이**: 이는 뷰포트의 높이를 나타냅니다.

- **Max-height**: 브라우저 창의 '최대 높이'를 정의합니다.

- **Min-height**: 브라우저 창의 '최소 높이'를 정의합니다.

- **방향**: 이는 뷰포트 방향(가로 또는 세로 모드)을 나타냅니다.

#### 논리 연산자

논리 연산자는 복잡한 미디어 쿼리를 구성하는 데 도움이 되며, not, and, only 등의 요소를 포함합니다. 또한 쉼표를 사용하여 하나 이상의 미디어 쿼리를 하나의 규칙으로 결합할 수 있습니다.

- **참고**: 'not 연산자'를 사용할 때는 미디어 유형을 지정해야 합니다. 일반적으로 'not 연산자'는 미디어 쿼리를 부정하는 데 사용됩니다.

- **그리고**: 두 개 이상의 미디어 기능을 하나의 미디어 쿼리로 결합하려면 'and' 연산자를 사용합니다. 이 연산자는 미디어 유형과 미디어 기능을 결합하는 데에도 사용할 수 있습니다.

- **Only**: 'only 연산자'는 구형 브라우저에 필수적입니다. 이 연산자를 사용하면 구형 브라우저가 미디어 쿼리를 올바르게 해석하여 'WordPress에서 미디어 쿼리가 작동하지 않습니다'와 같은 오류 문제를 방지할 수 있습니다. 또한 'not 연산자'를 사용할 때는 미디어 유형을 지정해야 합니다.

- **쉼표(,)**: 이 연산자는 여러 미디어 쿼리를 하나의 규칙으로 결합하는 데 사용됩니다. 쉼표로 여러 쿼리를 구분하면 각 쿼리는 개별적으로 처리됩니다. 또한, 쿼리 목록이 참이면 전체 미디어 쿼리 목록이 참 상태로 유지됩니다.

## 워드프레스에서 미디어 쿼리가 작동하지 않는 일반적인 이유

미디어 쿼리는 다양한 기기에서 반응형 디자인을 구현하는 데 필수적이지만, 워드프레스에서는 예상대로 작동하지 않는 경우가 있습니다. 다음은 가장 일반적인 원인과 해결 방법입니다

- **CSS 파일이 제대로 링크되지 않았거나 덮어쓰기됨**: 가장 흔한 문제 중 하나는 사용자 지정 CSS가 올바르게 적용되지 않는 것입니다. 이는 스타일시트가 제대로 링크되지 않았거나 다른 플러그인 또는 테마가 스타일을 덮어쓸 때 자주 발생합니다.

- **미디어 쿼리 구문 오류**: 미디어 쿼리는 효과적으로 작동하려면 올바른 구문으로 작성해야 합니다. 괄호 누락이나 "only screen"과 같은 잘못된 키워드 사용 등의 오류는 미디어 쿼리가 완전히 작동하지 않도록 만들 수 있습니다. 간단한 예제를 참고하여 쿼리 구조를 살펴보면 무엇이 잘못되었는지 파악하는 데 도움이 될 수 있습니다.

- **캐싱 문제(브라우저 또는 플러그인 관련)**: 사용자 지정 CSS와 미디어 쿼리가 올바르게 설정되어 있더라도 캐싱으로 인해 아무런 변경 사항이 없는 것처럼 보일 수 있습니다. WordPress 캐싱 플러그인과 브라우저 자체 캐시가 결합되어 종종 오래된 파일을 제공합니다.

#### 워드프레스 미디어 쿼리 수정에 도움이 필요하신가요?

반응형 디자인 문제나 사용자 지정 CSS가 제대로 적용되지 않는 문제로 여전히 어려움을 겪고 계시다면, 저희 워드프레스 전문가들이 도와드리겠습니다.

- [저희 서비스를 살펴보세요](https://seahawkmedia.com/wordpress/fixes/)

## 워드프레스에서 미디어 쿼리가 작동하지 않는 문제를 해결하는 방법

CSS 미디어 쿼리는 여러 가지 이유로 오류를 발생시킬 수 있습니다. 예를 들어 모바일 기기에서는 작동하지만 데스크톱에서는 작동하지 않을 수 있으며, 모든 기기에서 작동하지 않을 수도 있습니다. 사이트의 미디어 쿼리를 확인하려면 브라우저의 개발자 도구를 사용하여 사이트의 CSS를 검사하세요. '스타일 탭'을 클릭하면 해당 요소(구문)에 적용된 스타일을 확인할 수 있습니다.

대부분의 경우 '워드프레스에서 미디어 쿼리가 작동하지 않는' 이유는 매우 일반적입니다. 따라서 이 오류를 해결하는 몇 가지 방법을 소개합니다.

### 인라인 CSS 선언을 확인하세요

HTML 문서 내에 CSS를 선언한 경우 '워드프레스에서 미디어 쿼리가 작동하지 않습니다'라는 오류가 발생할 수 있습니다. 이 문제는 HTML 문서에서 'CSS를 인라인으로 선언'한 부분을 제거하면 해결할 수 있습니다.

또 다른 방법은 _`!important`를_ 사용하여 이 선언을 재정의하는 것입니다. 예를 들어 모바일 기기에서 단락의 텍스트 색상을 '회색'으로 변경하려면 다음 CSS 코드를 사용합니다.

```
@media 화면 및 (최대 너비: 1024px){
```

```
  피{        
```

```
        색상: 회색;
```

```
    }
```

```
}
```

하지만 동일한 요소에 인라인 스타일이 적용된 경우에는 이 방법이 효과가 없을 수 있습니다. 이러한 경우에는 ` _!important` 규칙을_ 인라인 스타일을 재정의하고 문제를 해결하세요.

```
@media 화면 및 (최대 너비: 1024px){
```

```
  피{        
```

```
        색상: 회색 !중요;
```

```
    }
```

```
}
```

### 미디어 쿼리 위치를 올바르게 지정하세요

'워드프레스에서 미디어 쿼리가 작동하지 않습니다'라는 오류의 또 다른 원인은 미디어 쿼리의 위치가 잘못되었기 때문입니다. 이를 해결하려면 미디어 쿼리를 스타일시트의 맨 끝에 추가하세요.

브라우저는 스타일시트를 위에서 아래로 읽기 때문에 스타일시트 끝부분에 있는 코드가 앞부분에 있는 선언을 덮어쓸 수 있습니다(단, `!important`를 사용하는 경우는 제외). 또한, 작은 쿼리의 경우 미디어 쿼리를 큰 화면 앞에 배치하는 것이 좋습니다.

**이 예시를 확인해 보세요**

```
몸 {
```

```
배경색: 검정색;
```

```
}
```

```
@media 화면 및 (최소 너비: 480px) {
```

```
몸 {
```

```
배경색: 파란색;
```

```
}
```

```
}
```

```
@media 화면 및 (최소 너비: 850px) {
```

```
몸 {
```

```
배경색: 연한 파란색;
```

```
텍스트 정렬: 가운데 정렬;
```

```
}
```

```
}
```

- 첫 번째 규칙은 화면 크기가 480픽셀 미만일 경우 배경색이 '검정'이라는 것입니다.

- 두 번째 미디어 쿼리에서 화면 크기가 480픽셀에서 849픽셀 사이이면 배경색은 '파란색'입니다.

- 마지막으로, 화면 크기가 580픽셀 이상이면 배경색은 '연한 파란색'으로 중앙에 정렬됩니다.

### 데스크톱 vs 모바일

미디어 쿼리를 설정하면 데스크톱과 모바일 모두에서 최적의 상태로 작동해야 합니다. 하지만 데스크톱이나 모바일에서 오류가 발생하는 경우, 다음 팁을 참고하여 문제를 해결하세요.

#### 데스크톱에서 미디어 쿼리가 작동하지 않습니다

미디어 기능에서 'max-width' 대신 'max-device-width'를 사용했다면 데스크톱에서 미디어 쿼리가 작동하지 않을 수 있습니다. 여기서 'max-width'는 기기의 디스플레이 영역 크기를 나타내고, 'max-device-width'는 기기(모바일)의 화면 크기를 나타냅니다.

'데스크톱에서 미디어 쿼리가 작동하지 않음' 오류를 해결하려면 미디어 기능을 'max-width'로 변경하세요. 이렇게 하면 기기의 실제 화면 크기가 아닌 브라우저의 표시 영역을 지정할 수 있습니다.

#### 모바일 기기에서 미디어 쿼리가 작동하지 않습니다

마찬가지로 뷰포트와 기본 확대/축소 배율을 설정하지 않으면 모바일 기기에서 미디어 쿼리가 작동하지 않는 문제가 발생할 수 있습니다. 이 문제를 해결하려면 사이트 헤더에 다음 코드를 추가하기만 하면 됩니다. 이 코드가 <head> 태그 안에 추가되었는지 확인하세요.<head></head> 요소.

```html
<meta name="viewport" content="width=device-width, initial-scale=1"/>
```

여기서 'width'는 뷰포트 크기를 나타내며, device-width로 설정됩니다. 이는 브라우저에게 웹사이트가 화면에 자연스럽게 맞춰 표시되도록 지시합니다. 반면 'initial-scale'은 확대/축소 수준을 정의합니다.

**읽어보세요**: [CSS @import를 사용하지 않고 페이지 로딩 속도를 향상시키는 방법](https://seahawkmedia.com/performance/avoid-css-import-improve-page-load-speed/)

## 결론

모든 사용자가 기기 종류에 관계없이 웹사이트에 접근할 수 있도록 하는 것은 매우 중요합니다. 반응형 웹사이트 디자인은 다양한 경로로 트래픽을 유도하는 데 도움이 됩니다. [구글의 모바일 우선 색인](https://developers.google.com/search/docs/crawling-indexing/mobile/mobile-sites-mobile-first-indexing) 웹페이지 색인 생성 속도도 빨라질 수 있습니다. 또한 모바일 기기에서 웹사이트를 이용하는 사용자에게 향상된 경험을 제공하여 검색 순위 향상에도 기여할 수 있습니다.

'워드프레스에서 미디어 쿼리가 작동하지 않습니다' 오류를 해결하는 것은 원인을 파악하면 간단합니다. 위에 언급된 팁을 따라 필요한 변경 사항을 적용하면 됩니다.

'워드프레스에서 미디어 쿼리가 작동하지 않습니다' 오류가 다시 발생하는 것을 방지하려면 [Simple Custom CSS](https://wordpress.org/plugins/simple-custom-css/) 및 [WP Add Custom CSS](https://wordpress.org/plugins/wp-add-custom-css/) 웹사이트에 미디어 쿼리를 추가하세요.

또한, '워드프레스에서 미디어 쿼리가 작동하지 않습니다' 오류를 해결할 수 없다면 저희에게 연락하세요. 저희는 [워드프레스 전문 에이전시](https://seahawkmedia.com/) 로서, 기업들이 웹사이트 다운타임 없이 [일반적인 워드프레스 오류를](https://seahawkmedia.com/ko/%EC%9C%A0%EC%A7%80%EB%B3%B4%EC%88%98/%EC%9B%8C%EB%93%9C%ED%94%84%EB%A0%88%EC%8A%A4%EC%97%90%EC%84%9C-%EA%B0%80%EC%9E%A5-%ED%9D%94%ED%95%9C-%EC%98%A4%EB%A5%98-10%EA%B0%80%EC%A7%80%EC%99%80-%ED%95%B4%EA%B2%B0-%EB%B0%A9%EB%B2%95/) 해결할 수 있도록 지원합니다

WP Services

## WordPress services at revolutionary pricing.

Productized WordPress services, from builds to care, delivered by Seahawk and tracked in one app. For the WordPress lovers.

[Go to WP Services](https://wpservices.com/) [Free homepage rebuild](https://seahawkmedia.com/free-homepage-rebuild/)
