HTML
PR

【HTML 3-1】よくあるつまずき|パス・画像が出ない・文字化けをやさしく解決する(初心者向け)

HTML3-1.webp
toshi
記事内に商品プロモーションを含む場合があります

※この記事は HTML の「つまずき対策」回です。
最初は、うまく表示されないことが普通です。
“自分には向いてない”ではなく、確認ポイントをまだ知らないだけなので大丈夫です。

HTMLを触り始めると、だいたい同じところで止まりやすいです。

  • 画像が出ない
  • リンクが開かない
  • CSSが効かない
  • 文字が変になる
  • 保存したのに反映されない

こういう時に必要なのは、難しい理屈より
**「どこから確認するか」** です。

この記事では、最初に出やすい“つまずき”を順番に整理します。

Q
「最初の不具合は“確認順”でかなり解決しやすいです」

最初のトラブルは、いきなり検索で深掘りしなくても大丈夫なことが多いです。

まずはこの順番で確認します。

1)保存したか
2)ファイル名が合っているか
3)置き場所(パス)が合っているか
4)ブラウザを更新したか
5)HTML/CSSの書き方がズレてないか

この順番だけでも、かなり前に進みやすくなります。

まず最初に確認すること

  • 保存したか(Ctrl+S / MacはCmd+S)
  • ブラウザを更新したか
  • VS Codeで“フォルダ”を開いているか
  • ファイル名や拡張子が想定どおりか
  • 半角/全角の打ち間違いがないか
toshi
toshi

最初は、意外と「保存忘れ」が多いです。
まずそこだけ見ても十分進みます。

画像が出ない

つまずき①

一番多いのは、やっぱり画像です。
でも確認ポイントはかなり決まっています。

  • images フォルダを作ったか
  • その中に sample.jpg を入れたか
  • img の src が `images/sample.jpg` になっているか
  • ファイル名の大文字小文字が一致しているか
  • 拡張子が `.jpg` なのか `.jpeg` なのか確認したか

例:
HTMLファイルと同じ場所に images フォルダがある場合

`index.html`
`images/sample.jpg`

この時の src はこう書きます。

<img src="images/sample.jpg" alt="サンプル画像" width="480" />
HTML
Q
「補足:パスって何?」

パスは「そのファイルがどこにあるか」を書くものです。

`images/sample.jpg` は、
「今いる場所から見て、images フォルダの中の sample.jpg」
という意味です。

最初は “住所みたいなもの” と思っておけば十分です。

リンクが開かない

つまずき②

a タグのリンクは、href の書き方がズレると動きません。

  • href の中身に `https://` が入っているか
  • 引用符 `”` が閉じているか
  • a タグの閉じタグ `</a>` があるか
  • リンク先URLそのものが間違っていないか
<a href="https://developer.mozilla.org/ja/" target="_blank" rel="noopener noreferrer">
MDN(日本語)
</a>
HTML

target="_blank" は、リンク先を新しいタブで開く指定です。
今見ているページを残したまま、別のページを開きたい時によく使います。

rel="noopener noreferrer" は、安全のために付ける指定です。
target="_blank" を使う時は、セットで書くと覚えておけば大丈夫です。

CSSが効かない

つまずき③

CSSが効かないと焦りやすいですが、最初はだいたい原因が絞れます。

  • head の中に 下記コードを書いたか
<link rel="stylesheet" href="style.css" />
HTML
  • style.css という名前になっているか
  • index.html と style.css が同じ階層にあるか
  • CSSの最後に `;` を付け忘れていないか
  • 中括弧 `{ }` が閉じているか
ありがちな原因確認する所
CSSファイル名が違うstyle.css になっているか
読み込みを書いてない link タグがあるか
記号ミス`;` `{}` が閉じているか
HTML側にそのタグがないたとえば p にCSSを書いているのに
HTMLに p がない

文字化けする

つまずき④

日本語が変な文字になる時は、まず meta charset を確認します。

  • head の中に下記コードがあるか
<meta charset="utf-8" />
HTML
  • ファイルを保存し直したか
  • ブラウザを更新したか

最初は、ほとんどこれで大丈夫です。
いまの教材の流れでは、head の中に毎回入れておけばかなり安心です。

Live Serverで表示できない

つまずき⑤

  • VS Codeで“フォルダ”を開いているか
  • 右下に「Go Live」が出ているか
  • 拡張機能 Live Server が有効か
  • index.html を開いているか
  • ブラウザを閉じずに、更新だけで確認しているか

Live Serverは「ファイル1個だけ開く」より、
フォルダごと開いている方が安定しやすいです。

何が悪いか分からない時

つまずき⑥

そんな時は、いったん“前に動いていた状態”まで戻すのが一番早いです。

  • 最後に動いていたコードまで戻す
  • 1か所だけ直して保存する
  • ブラウザを更新して確認する
  • 変化があったら次へ進む
toshi
toshi

一気に3つ直すと、どこが原因か分かりにくくなります。
1か所ずつで大丈夫です。

ここだけ覚えれば十分

最初のトラブル対策まとめ

症状まず見る所
画像が出ないsrc とファイルの場所
リンクが開かないhref と引用符
CSSが効かないlink タグとファイル名
文字化けmeta charset
表示されない 保存・更新・Live Server

ママのための1ヶ月
フリーランス向け報酬即日払いサービス
できた判定

今日のゴール確認

ここまでできたらOKです。

  • 最初につまずきやすい所が分かった
  • 画像/リンク/CSS/文字化けの確認ポイントを持てた
  • “どこから確認するか” の順番が持てた
  • 次の章へ安心して進みやすくなった
次に読む

CSS 0-0へ戻る/進む

HTMLの土台と、つまずき対策がそろいました。
次はCSSで見た目を整えていく流れに進みます。

PR:最初の1冊(必要な方だけ)

PR:HTML/CSSを進めるための参考(必要な方だけ)
最初の土台づくり用に、1冊だけ置いておきます。
※価格や在庫は変わるため、最終確認はリンク先でお願いします。

メールアドレスが公開されることはありません。 が付いている欄は必須項目です

ABOUT ME
toshi
toshi
フルスタックエンジニア
C型肝炎や感染症の闘病を経て現在通院中
フリーランスとして今日を生きる、それがすべて。
静かな光の中で、歩みを止めずに生きていく。
実験大好きなので色々とやっていきます。
記事URLをコピーしました