CSSが効かないときに原因を調べる

よく使う流れ 採用 HTML / CSS / JavaScriptトラブル解決 更新 2026-09-29
要点

書いたCSSが効かないとき、DevToolsで「ルールがない/負けている/勝っているのに変わらない」の3つに分けて調べる。

使う場面

  • CSSを追加・変更したのに見た目が変わらない
  • PCでは効くのにスマホだけ効かない(またはその逆)

最初に確認

  • キャッシュ(ブラウザ・キャッシュプラグイン・サーバー・Elementorの生成CSS)を消したか、シークレットウィンドウで見ているか(WordPressの変更が反映されない(キャッシュの種類と消し方))
  • 見ている要素が本当に対象か(同じクラスが複数ないか)
  • どの幅で起きているか(メディアクエリの範囲)

手順

  1. DevTools で対象の要素を選ぶ(右クリック → 検証)。
  2. Styles を見て、次の3つのどれかに分ける(CSSが効かない・変更が反映されないときのチェックリスト)。
    • A. ルールが出てこない: セレクタの誤り、CSSが読み込まれていない、} の不足、別の幅のメディアクエリの中
    • B. 打ち消し線(負けている): 詳細度、後から読み込まれたテーマ・Elementor、!important・インライン style(足し方は CSSを追加するときの優先順位(詳細度・読み込み順・テーマとElementorの競合))
    • C. 勝っているのに変わらない: 前提不足(z-index に position、インライン要素の width)、上に別の要素が重なっている
  3. Computed で最終的な値を確認する。
  4. 直すCSSは最小限・専用クラスの範囲で追加する(既存ルールは書き換えない)。
  5. PC・390px の両方と、同じCSSを使う別ページで確認する。

Claude / AIへ送る指示

CSSが効かない原因の調査だけしてください。まだ修正しないでください。
対象ページ: 〔URL〕
対象要素: 〔セレクタ/見た目の説明〕
期待: 〔例: 390pxでボタンを1行にしたい〕
追加したCSS: 〔貼る〕
実ブラウザで対象要素の Computed の値と、そのプロパティを決めているルール(ファイル・セレクタ・詳細度)を確認し、
「ルールがない/負けている/勝っているのに変わらない」のどれかと、最小の修正案を報告して止まってください。

コマンド

【読み取り】 要素を選んだ状態で、ブラウザのコンソールで($0 は選択中の要素):

// 最終的な値を確認(プロパティ名は調べたいものに変える)
const s = getComputedStyle($0); [s.display, s.position, s.zIndex, s.width, s.marginTop]
// その位置で一番上にある要素(重なりの確認)
const r = $0.getBoundingClientRect(); document.elementFromPoint(r.left + r.width / 2, r.top + r.height / 2)
// 同じクラスがいくつあるか
document.querySelectorAll('.〔クラス名〕').length

最後の確認

  • PC・390px で意図どおり
  • 同じCSSを使う別ページ・既存部分に影響がない
  • キャッシュを消した状態・シークレットウィンドウでも効いている

注意点