• 검색어를 입력해 주세요.
  • 검색어를 입력해 주세요.
디자인키트 0
블로그 전체목록

그누보드 테마 CSS 수정했는데 적용 안 될 때 | 파일 경로·캐시 확인 방법

기술정보 26.11.18 조회 14



GNUBOARD · CSS TROUBLESHOOTING

그누보드 테마에서 글자 색상이나 배너 여백을 수정했는데, 저장한 내용이 홈페이지에 반영되지 않는 경우가 있습니다.

CSS 파일을 수정하고 서버에 다시 업로드했는데도 화면은 이전과 같거나, PC에서는 바뀌었는데 모바일에서는 그대로 보이기도 합니다.

이럴 때는 수정한 코드가 잘못됐다고 생각하기 쉽지만, 실제로는 다른 CSS 파일을 수정했거나 브라우저가 이전 파일을 불러오고 있을 수 있습니다. 기존 스타일이 새로 작성한 CSS보다 우선 적용되는 경우도 있습니다.

그누보드 테마 CSS가 적용되지 않는다면 수정한 파일이 실제 페이지에서 사용되는지, 브라우저에 이전 CSS가 남아 있는지, 다른 스타일에 의해 덮어써지고 있는지 순서대로 확인하는 것이 좋습니다.

이번 글에서는 디자인키트 그누보드 테마의 파일 구성 예시를 바탕으로 CSS가 반영되지 않을 때 확인할 부분을 살펴보겠습니다.

그누보드 테마에서 수정한 CSS 파일이 맞는지 확인하세요

그누보드 테마는 홈페이지 전체에 적용되는 공통 스타일과 특정 화면에 사용하는 스타일이 서로 다른 파일에 작성되어 있을 수 있습니다.

디자인키트 공식 그누보드 테마 가이드에서도 공통 CSS와 메인배너 등 개별 구성의 CSS 경로를 구분해 안내하고 있습니다.

예를 들어 공식 가이드에 소개된 공통 CSS 경로는 다음과 같습니다.

CSS FILE PATH

theme/co1070-res/css/sh_common.css

여기서 co1070-res는 가이드에 사용된 디자인 코드 예시입니다. 실제 구매한 테마에서는 폴더명과 파일 구성이 다를 수 있습니다.

이런 구조에서는 메인배너에 적용된 스타일을 바꾸려고 공통 CSS만 수정하더라도 원하는 결과가 나타나지 않을 수 있습니다.

반대로 여러 페이지에 공통으로 적용되는 스타일을 변경할 때 개별 페이지의 CSS만 수정하면 다른 화면에는 반영되지 않을 수 있습니다.

따라서 수정하려는 요소가 어느 파일에 정의되어 있는지 먼저 확인해야 합니다.

디자인키트의 그누보드 테마 커스터마이징 가이드에서는 주요 파일 구성과 이미지·CSS·스크립트 경로 예시를 확인할 수 있습니다.

실제 수정 작업에서는 가이드의 예시 경로를 그대로 입력하기보다 구매한 테마의 파일 구조와 브라우저에서 불러오는 CSS 경로를 함께 확인하는 것이 정확합니다.

크롬 개발자 도구에서 실제 적용된 CSS 경로 찾기

CSS 파일이 여러 개라면 파일명을 하나씩 열어 찾는 것보다 브라우저 개발자 도구를 활용하는 편이 효율적입니다.

예를 들어 홈페이지 메인배너의 제목 색상을 변경하려는 상황이라고 가정해 보겠습니다.

먼저 크롬에서 해당 홈페이지를 열고 수정하려는 제목 위에서 마우스 오른쪽 버튼을 클릭합니다.

메뉴에서 검사를 선택하면 개발자 도구의 Elements 패널이 열립니다.

이곳에서는 선택한 HTML 요소와 연결된 CSS를 확인할 수 있습니다.

개발자 도구에서 확인할 정보

Elements — 선택한 HTML 요소의 구조

Styles — CSS 선택자와 선언, 스타일 파일 위치

Computed — 요소에 최종 적용된 스타일 값

화면 오른쪽의 Styles 영역을 보면 해당 요소에 적용되는 선택자와 CSS 속성, 스타일 파일의 위치가 표시됩니다.

원하는 속성이 어느 파일에서 작성됐는지 확인한 뒤 해당 파일을 수정하면 됩니다.

여기서 중요한 것은 개발자 도구에 표시되는 경로가 현재 브라우저에서 실제로 불러온 CSS 파일의 위치라는 점입니다.

예를 들어 공통 CSS가 아닌 메인배너 폴더 안의 style.css에서 색상을 지정하고 있다면 해당 파일도 확인해야 합니다.

파일 위치를 찾았다면 서버에 업로드한 파일의 경로와 비교해 보세요.

비슷한 이름의 파일이 여러 개 있거나 테마를 복사해 사용하고 있다면 수정한 파일과 실제 적용된 파일이 서로 다를 수 있습니다.

CSS 파일을 수정했는데 저장 전 화면이 계속 보인다면?

올바른 CSS 파일을 수정하고 업로드했는데도 이전 디자인이 보인다면 브라우저 캐시를 확인할 차례입니다.

브라우저는 웹페이지를 더 빠르게 불러오기 위해 CSS나 이미지 같은 파일을 임시로 저장할 수 있습니다.

이 때문에 서버의 CSS가 변경됐어도 브라우저에서 이전에 저장한 파일을 사용하면 수정 전 디자인이 표시될 수 있습니다.

먼저 해당 페이지에서 강력 새로고침을 시도해 보세요.

WINDOWS · CHROME

Ctrl + Shift + R

윈도우 크롬에서는 Ctrl + Shift + R을 사용할 수 있습니다.

그래도 수정 사항이 보이지 않는다면 개발자 도구의 Network 패널에서 캐시 사용 여부를 확인할 수 있습니다.

크롬 개발자 도구에서 확인하는 방법

  1. F12를 눌러 개발자 도구를 엽니다.
  2. 상단에서 Network 탭을 선택합니다.
  3. Disable cache 항목을 체크합니다.
  4. 개발자 도구를 연 상태로 페이지를 새로고침합니다.
  5. 수정한 CSS가 화면에 반영되는지 확인합니다.

Disable cache는 개발자 도구가 열려 있는 동안 브라우저 캐시를 사용하지 않도록 하는 기능입니다.

이 상태에서 수정 내용이 정상적으로 보인다면 기존에 저장된 CSS가 원인이었을 가능성이 있습니다.

다만 캐시를 비활성화해도 화면이 그대로라면 다른 원인도 살펴봐야 합니다.

Network 패널에서 CSS 파일의 요청 상태를 확인하고, 필요한 경우 해당 파일의 Response 내용을 열어 수정한 코드가 실제로 포함되어 있는지 확인할 수 있습니다.

파일 요청이 404 오류로 실패했다면 경로가 잘못됐거나 해당 위치에 파일이 없는지 확인해야 합니다.

정상적으로 불러온 파일에 수정한 코드가 없다면 서버 업로드 경로나 파일 버전부터 다시 살펴볼 필요가 있습니다.

CSS가 정상적으로 불러와져도 적용되지 않을 수 있습니다

CSS 파일을 제대로 수정했고 브라우저에서도 최신 파일을 불러왔는데, 여전히 색상이나 크기가 바뀌지 않는 경우가 있습니다.

이때는 같은 HTML 요소에 여러 CSS 규칙이 적용되고 있는지 확인해야 합니다.

예를 들어 다음 HTML 구조를 사용한다고 가정해 보겠습니다.

HTML 예제

<section class="main-banner">
  <h2 class="banner-title">서비스 소개</h2>
</section>

제목 색상을 파란색으로 변경하기 위해 다음 CSS를 작성했습니다.

수정한 CSS

.banner-title {
  color: #2463eb;
}

그런데 다른 스타일 파일에 아래 코드가 있다면 결과가 달라질 수 있습니다.

다른 CSS 파일의 선언

.main-banner .banner-title {
  color: #ffffff;
}

같은 요소에 적용되는 두 규칙이 충돌할 경우, 이 예제에서는 더 구체적인 선택자인 .main-banner .banner-title의 색상이 적용됩니다.

따라서 .banner-title의 색상을 바꿨더라도 제목이 흰색으로 보일 수 있습니다.

이럴 때는 개발자 도구의 Styles 영역에서 어떤 CSS 선언이 실제 적용되고 있는지 확인합니다.

적용되지 않은 속성은 취소선으로 표시될 수 있으며, Computed 영역에서 최종 적용된 값도 확인할 수 있습니다.

단순히 원하는 속성에 !important를 추가하기보다는 어떤 규칙이 우선 적용되는지 확인하고 해당 스타일을 수정하는 편이 좋습니다.

CSS 우선순위는 선택자의 구체성뿐 아니라 스타일의 중요도, 선언 순서 등에도 영향을 받으므로 실제 충돌 상황을 확인해야 합니다.

※ 위 HTML과 CSS는 원리를 설명하기 위한 예제이며, 디자인키트 판매 테마에서 가져온 실제 코드는 아닙니다.

PC에서는 수정됐는데 모바일에서만 적용되지 않는다면?

그누보드 테마를 수정할 때 PC와 모바일 화면을 함께 확인해야 하는 이유도 있습니다.

반응형 테마에서는 화면 너비에 따라 다른 스타일을 적용하도록 미디어쿼리를 사용하기 때문입니다.

예를 들어 PC 화면의 제목 크기를 변경하기 위해 다음 코드를 작성했다고 가정하겠습니다.

PC 제목 크기 예제

.banner-title {
  font-size: 36px;
}

그런데 같은 파일의 다른 위치에 다음과 같은 코드가 있다면 모바일에서는 별도 크기가 적용될 수 있습니다.

모바일 미디어쿼리 예제

@media (max-width: 768px) {
  .banner-title {
    font-size: 24px;
  }
}

화면 너비가 768px 이하이고 다른 규칙이 우선하지 않는다면 제목 크기는 24px로 표시됩니다.

PC에서 변경한 36px이 모바일에 그대로 적용되지 않는 이유입니다.

이 경우에는 모바일 화면에서 적용되는 미디어쿼리를 찾아 필요한 값을 수정해야 합니다.

디자인키트의 반응형 그누보드 테마 가이드에서도 CSS 미디어쿼리를 활용한 화면 대응 방식을 안내하고 있습니다.

다만 테마마다 반응형 구성과 파일 구조가 다르므로 동일한 미디어쿼리가 사용된다고 생각하면 안 됩니다.

또한 게시판 화면에서만 스타일이 다르게 나타난다면 테마의 공통 CSS뿐 아니라 해당 게시판 스킨에 적용된 CSS도 함께 확인해 보세요.



서버에 파일을 다시 업로드했는데도 적용되지 않을 때

브라우저에서 확인한 CSS 경로와 서버에 업로드한 파일 경로가 같은데도 수정 내용이 보이지 않는다면 업로드 상태를 다시 확인해야 합니다.

FTP 프로그램에서 파일을 수정한 뒤 서버에 올렸다고 생각했지만 실제로는 로컬 파일만 변경됐거나 다른 폴더에 업로드된 경우도 있을 수 있습니다.

특히 여러 테마를 사용하거나 기존 테마를 복사해 수정하는 환경이라면 폴더 이름이 비슷해 혼동하기 쉽습니다.

서버에 있는 CSS 파일을 다시 열어 수정한 내용이 저장되어 있는지 확인해 보세요.

여기서 수정한 코드가 확인되는데도 브라우저의 Network 응답에는 이전 내용이 남아 있다면 중간 캐시나 배포 환경도 점검해야 합니다.

사이트에서 CDN이나 별도의 캐시 시스템을 사용한다면 해당 환경의 캐시 정책이 영향을 줄 수 있습니다.

운영 환경에 따라 CSS 파일의 URL에 버전 정보를 부여해 새 파일을 불러오도록 관리하는 방법도 있습니다.

예를 들어 기존 CSS 주소에 버전 매개변수를 추가하는 방식입니다.

CSS 파일 버전 관리 예제

<link rel="stylesheet"
      href="/theme/example/css/style.css?v=2">

다만 이 코드는 버전 관리 방식의 예시입니다. 실제 그누보드 테마에서는 CSS가 PHP 파일에서 호출될 수 있으므로 기존 연결 방식을 확인한 뒤 적용해야 합니다.

파일 경로를 임의로 변경하거나 동일한 CSS를 중복으로 불러오지 않도록 주의해야 합니다.

CSS가 적용되지 않을 때는 이 순서로 점검해 보세요

지금까지 살펴본 내용을 실제 작업에 적용하면 다음과 같은 순서로 확인할 수 있습니다.

01 · CSS 파일 경로 확인

첫째, 수정한 CSS 파일이 현재 페이지에서 실제로 사용되는 파일인지 확인합니다.

개발자 도구의 Elements와 Styles 영역에서 CSS 경로를 찾고, 서버에 업로드한 파일과 비교합니다.

02 · 최신 CSS 및 캐시 확인

둘째, 브라우저가 최신 CSS를 불러오는지 확인합니다.

Network 패널에서 캐시를 비활성화하고, 실제 CSS 응답에 변경한 코드가 포함되어 있는지 확인합니다.

03 · CSS 충돌 여부 확인

셋째, 다른 CSS 규칙이 수정한 값을 덮어쓰고 있는지 살펴봅니다.

선택자와 적용 순서, 미디어쿼리를 확인하고 필요한 부분을 수정합니다.

04 · PC·모바일 화면 검증

넷째, PC와 모바일, 게시판 등 관련 화면을 테스트합니다.

공통 CSS를 수정했다면 다른 페이지에도 영향을 줄 수 있으므로 실제로 표시되는 화면을 함께 확인하는 것이 좋습니다.

특히 운영 중인 홈페이지라면 원본 파일을 백업한 뒤 수정하고, 가능하다면 테스트 환경에서 먼저 적용 결과를 확인하는 편이 안전합니다.

디자인키트 그누보드 테마를 수정할 때 참고할 가이드

디자인키트에서는 업종별 홈페이지 템플릿과 그누보드 테마 관련 자료를 제공하고 있습니다.

그누보드 테마를 적용한 상품은 PHP 파일과 CSS, JavaScript, 게시판 스킨 등으로 구성될 수 있어 HTML 파일만 수정하는 작업과는 확인해야 할 부분이 다릅니다.

디자인키트 공식 가이드에서는 테마 설치부터 주요 파일 경로, 이미지와 텍스트 수정, 메뉴와 게시판 연동에 관한 내용을 확인할 수 있습니다.

DESIGN KITS · OFFICIAL GUIDE

그누보드 테마 수정에 필요한 공식 가이드

디자인키트 그누보드 테마 사용 가이드

그누보드 테마 커스터마이징 가이드

테마를 수정할 때는 해당 가이드와 실제 구매한 상품의 파일 구조를 함께 살펴보세요.

특히 공통 CSS와 개별 구성의 CSS가 나뉘어 있다면 수정할 화면에 연결된 파일을 찾는 것이 먼저입니다.

사용 중인 테마의 구조를 확인한 뒤 필요한 부분만 수정하면 다른 화면에 영향을 주는 불필요한 변경을 줄일 수 있습니다.

자주 묻는 질문

Q. 그누보드 테마 CSS를 수정했는데 새로고침해도 바뀌지 않는 이유는 무엇인가요?

수정한 파일과 실제로 불러오는 CSS 파일이 다르거나, 브라우저에 이전 CSS가 저장되어 있을 수 있습니다. 다른 CSS 규칙이 수정한 속성보다 우선 적용되는 경우도 있으므로 개발자 도구에서 파일 경로와 적용 상태를 확인해야 합니다.

Q. 그누보드 테마의 CSS 파일은 어디에서 수정하나요?

테마에 따라 다릅니다. 디자인키트 공식 가이드에서는 공통 CSS와 메인배너 등 개별 구성의 CSS 경로를 구분하고 있습니다. 구매한 테마의 실제 폴더 구조를 확인하고, 브라우저 개발자 도구에서 수정할 요소에 연결된 파일을 찾는 것이 좋습니다.

Q. CSS 파일을 수정할 때마다 캐시를 삭제해야 하나요?

항상 필요한 것은 아닙니다. 최신 CSS가 정상적으로 불러와진다면 캐시를 삭제할 필요가 없습니다. 수정 사항이 반영되지 않을 때는 강력 새로고침이나 개발자 도구의 캐시 비활성화 기능을 사용해 원인을 확인할 수 있습니다.

Q. PC에서는 CSS가 적용되는데 모바일에서만 적용되지 않는 이유는 무엇인가요?

반응형 스타일에 사용된 미디어쿼리 때문에 모바일에 다른 CSS 값이 적용될 수 있습니다. 해당 화면 너비에서 어떤 스타일이 실제로 적용되는지 확인하고 필요한 규칙을 수정해야 합니다.

CSS 파일을 다시 수정하기 전에 적용 경로부터 확인해 보세요

그누보드 테마에서 CSS가 반영되지 않을 때는 무조건 코드를 다시 작성하거나 새로운 속성을 추가할 필요는 없습니다.

우선 현재 페이지에서 사용하는 CSS 파일을 확인하고, 서버에 업로드한 파일과 일치하는지 살펴보세요.

파일 경로가 정확하다면 브라우저 캐시와 CSS 적용 우선순위를 확인하는 순서로 접근할 수 있습니다.

디자인키트 그누보드 테마를 활용하고 있다면 공식 가이드에서 파일 구조를 확인하고, 수정한 CSS가 실제 화면에 어떻게 적용되는지 개발자 도구로 점검해 보세요.

문제가 발생한 위치를 먼저 찾으면 불필요한 코드 변경을 줄이고 기존 디자인을 유지하는 데 도움이 됩니다.

DESIGN KITS

디자인키트 HTML 소스 가격 개편 안내

디자인키트는 2026년 9월 HTML 템플릿 가격을 개편했습니다.

일반형 HTML 소스는 기존 165,000원에서 39,000원으로 변경됐으며, 그누보드 테마 적용 여부와 상품별 옵션에 따라 최종 구매 가격은 달라질 수 있습니다.

디자인키트 HTML 템플릿 가격 개편 안내

작성자: 디자인키트

작성일: 2026.11.18

최종 수정일: 2026.11.18

블로그 전체목록
디자인키트 카카오상담