ファイルの扱い
ウェブサイトは、テキストコンテンツ、コード、スタイルシート、メディアコンテンツなど、多くのファイルで構成されています。ウェブサイトを構築する際は、まずローカルコンピューター上でこれらのファイルを適切な構造にまとめ、ファイル同士が正常に連携することが可能であることを確認し、すべてのコンテンツの見栄えを適切に整えた上で、最終的にサーバーにアップロードして世界中に公開する必要があります。この記事では、コンピューターのファイルエクスプローラーのインターフェイス (UI) をどのように使用するか、そしてウェブサイトに適したファイル構造をどのように設定するかについて説明します。
| 前提条件: | コンピューターのオペレーティングシステム (OS) と、ウェブサイトを構築するための基本的なソフトウェアに慣れていること。 |
|---|---|
| 学習成果: |
|
ファイルとフォルダーの扱い
コンピューター内のファイルやフォルダーを作成・編集する方法は、さまざまなものがあります。コンピューターのコマンドラインや端末で一連のテキストコマンドを使って操作することも可能ですが、その詳細については次の記事で解説します。しかし、多くの人にとっては、ファイルシステムについて視覚的に学ぶ方が理解しやすいでしょう。そこで、ここではその方法について解説します。現行のオペレーティングシステム (OS) には、必要に応じてファイルやフォルダーを操作できる、堅牢なファイルシステムユーザーインターフェイス (UI) を使用することができます。
例えば、macOS には Finder というプログラムがあります。

一方、Windows にはファイルエクスプローラーがあります。

メモ: このガイドは、Windows 11 および macOS 15 を使用して作成されました。お使いの OS のバージョンが異なる場合や、まったく別の OS を使用している場合は、使い勝手が異なる可能性があります。OS の基本的な使い方については、ウェブ上に多くのガイドがあります。お使いの OS に関する情報は、ウェブで検索することをお勧めします。
基本構造
現行のオペレーティングシステムのほとんどには ユーザー フォルダーがあり、そこにはシステム上に存在するそれぞれのユーザーアカウントごとのフォルダーが含まれています。これは、ユーザーの「ホーム」フォルダーとも呼ばれます。通常、探しやすいように家のアイコンで表されています。また、ホームフォルダーには、「ドキュメント」や「ミュージック」など、そのユーザーに特有の重要な標準フォルダー(およびファイル)が含まれています。コンピューター上には他にも多くのファイルやフォルダーがありますが、現時点ではそれらについては気にしなくて大丈夫です。
デフォルトで、現在ログインしているユーザーは、自身のホームフォルダーにしかアクセスできません。
作業に関連するプロジェクトファイルは、ホームフォルダー内のどこか、たとえば「ドキュメント」フォルダーの中に作成することをお勧めします。ウェブページのファイルは多くの場合「ドキュメント」と呼ばれるため、これは意味があります。
警告: システム上の他の場所(例えば、オペレーティングシステムや重要なアプリケーションを制御する領域など)でファイルの作成や編集を始めると、何かが正常に動作しなくなることがあります。操作内容を十分に理解するまでは、ホームフォルダー内でのみファイルの作成や編集を行うようにしてください。
フォルダーの作成
すべてのウェブプロジェクトを格納するために新しいフォルダーを作成しましょう。
- ファイルシステムの UI で、「ホーム」フォルダーをクリックし、次に「ドキュメント」フォルダー内をダブルクリックしてください。
- この場所に
web-projectsという名前の新しいフォルダーを作成してください。- Windows では、ファイルエクスプローラーのウィンドウで「新規作成」ボタンを選択し、「フォルダー」を選択するか(または Ctrl + Shift + N を押す)、現れた新しいフォルダーのアイコンに
web-projectsと名前を入力し、Enter/Return キーを押します。 - macOS では、Finder メニューから ファイル > 新規フォルダ を選択します(または Cmd + Shift + N を押す)、untitled folder という名前の新しいフォルダが現れます。フォルダー名をクリックして編集が始め、
web-projectsを入力して、Enter/Return キーを押します。
- Windows では、ファイルエクスプローラーのウィンドウで「新規作成」ボタンを選択し、「フォルダー」を選択するか(または Ctrl + Shift + N を押す)、現れた新しいフォルダーのアイコンに
入力ミスをした場合は、フォルダー名を編集して修正することができます(ファイルについても同様です)。
- Windows では、フォルダーを右クリックし、メニューから「名前の変更」を選択して、名前を変更してください。Windows のバージョンによっては、最初に示されるメニューが簡略化されている場合があります。その場合は、右クリックして「その他のオプションを確認」を選択し、そこから「名前の変更」を選択する必要があるかもしれません。
- macOS では、フォルダー内の名前をクリックまたは選択して編集します。
VS Code でプロジェクトフォルダーを開き、ファイルを作成する
OS のファイルシステム UI 内でテキストファイルを作成することも可能ですが、一般的にはコードエディター内で作成するほうが簡単で、エラーの可能性も低いです。実際、VS Code には独自のファイルエクスプローラーが搭載されており、ウェブプロジェクトに必要なすべてのフォルダーやファイルを作成することができます。
では、なぜわざわざ OS のファイルシステム UI を使用してフォルダーを作成する手間をかけさせたのでしょうか。それは、VS Code に初期の最上位フォルダーを指す必要があるからです。
同時に、OS のファイルシステムがどのように構成されているかを少し理解しておくことも有益です。これは、後でより複雑なツールを使用するようになると、さらに有益になるでしょう。
web-projects フォルダーを VS Code で開いてみましょう。
- VS Code を開きます。
- メニューから ファイル > フォルダーを開く... を選択します。
メモ: キーボード操作のユーザーは、Windows では Ctrl キーを押したまま、K、続いて O を押すことで、フォルダーを開く コマンドを実行可能です。macOS ユーザーの場合、最も簡単な方法は、Cmd + Shift + P で コマンドパレット を開き、"Open Folder" を入力してコマンド一覧を絞り込み、カーソルキーを使って ファイル: フォルダーを開く まで移動し、Enter キーを押すことです。
- OS のファイルシステム UI のミニ版が現れます。これを使って
web-projectsフォルダーを探し、それを選択してから、フォルダーを選択 ボタンを押してください。 - このフォルダー内のファイルの作成者を信頼しますか? というタイトルのダイアログボックスが表示されます。その内容をよく読んで、何が問われているのかを理解してください。現時点では、このフォルダーにファイルを作成するのはあなただけですので、はい、作成者を信頼します をクリックしてください。
次の図のように、VS Code の エクスプローラー ペインに web-projects フォルダーが開いているのが確認できるはずです。

警告: 繰り返しになりますが、システムに問題が発生しないように、ホーム フォルダー内の自分のファイルのみを編集するようにしてください。
VS Code のキーボードナビゲーションに関する余談
VS Code は決して完璧というわけではありませんが、豊富なキーボードショートカットが用意されています。この記事では、可能な限り役立つものを記載するように努めましたが、より包括的な一覧については、VS Code のキーボードショートカットリファレンスをご覧ください。
一般的に、キーボードを使って VS Code を操作したい場合は、Tab キーを押すと、UI のさまざまな領域間を移動できます(Shift + Tab を押すと、前回のタブのフォーカス位置に移動します)。タブのフォーカス位置に複数のボタンがある場合は、カーソルキーを使ってそれらの間を移動できます。
現在ファイルを編集中の場合、Tab キーを押してもUI内を移動することはできず、ファイル内にタブ文字が追加されます。編集中のファイルから エクスプローラー ペインに移動するには、macOS では Cmd + Shift + E で、Windows では Ctrl + Shift + E で可能です。
ファイルエディターペインに戻り、異なるタブで開いているファイル間を移動するには、Ctrl キーを押したまま、Tab キーや Shift + Tab キーを使用して、開いているタブのリストを上下に移動します(macOS と Windows の両方で利用可能です)。編集したいファイルをハイライトしたら、キーを離してそのタブに移動されます。
ファイルの作成
ここから、エクスプローラー ペインの上部にある各ボタンを使用して、新しいファイルやフォルダーを作成できます。
- 新しいファイル... アイコンをクリックして新しいファイルを作成します(または、Tab キーでそのアイコンに移動し、Enter/Return キーを押します)。
- 現れたテキスト入力ボックスにファイル名として "index.html" と入力し、Enter/Return キーを押します。
メモ: Welcome タブの上部にあるボタンは、動作が少し異なるため、ファイルやフォルダーを作成する際には使用しないでください。実際、Welcome タブには必要がないので、閉じて構いません。タブの右側にある "x" をクリックするか、macOS では Cmd + W(Windows では Ctrl + W)を押して閉じるのが最適です。
ここで、OS のファイルシステム UI に戻り、web-projects フォルダーをダブルクリックして開くと、そこに index.html ファイルも表示されているはずです。VS Code は独自の奇妙なファイルシステムを使用しているわけではなく、基盤となる OS のファイルシステムを利用しています。
index.html を専用のサブフォルダーに移動
フォルダー内に、他のフォルダー(サブフォルダー と呼ばれる)を、好きなだけ階層を重ねて作成することができます。また、ファイル(やフォルダー)を他のフォルダーの上にドラッグ&ドロップすることで、そのフォルダー内に移動させることも可能です。
これについて詳しく見ていきましょう。その過程で、index.html ファイルを専用のサブフォルダー内に移動させます。このファイルをメインの web-projects フォルダー内にはそのまま置いておくのはあまり望ましくないからです。
- VS Code の エクスプローラー ペインにある 新しいフォルダー... ボタンを使用して、
web-projects内に新しいフォルダーを作成します。 test-siteと名付けます。- これで、
index.htmlファイルをtest-siteフォルダーの上にドラッグ&ドロップして、そのフォルダー内にファイルを移動できるようになったはずです。メモ: キーボードのユーザーの場合は、以下の手順に従って操作できます。
- 上矢印キーと下矢印キーを使用して、フォーカスの枠を
index.htmlファイルの上に移動させてください。 - macOS では Cmd + X(Windows では Ctrl + X)を押して、移動されるファイルを選択します。
- 矢印キーを使用して、フォーカスの枠をフォルダー内に移動させてください。
- macOS では Cmd + V を(Windows では Ctrl + V を)押して、そのフォルダー内にファイルを移動してください。
- 上矢印キーと下矢印キーを使用して、フォーカスの枠を
OS のファイルシステム UI や VS Code の使い方については、まだ記載したいことがたくさんありますが、紙面の都合上、今回はここまでとします。これで、まずは始めるのに十分な情報は得られたはずです。ファイルやフォルダーに関するその他の操作方法については、ぜひウェブで検索してみてください。
それでは、ウェブサイトの構成について簡単な解説に移りましょう。
ウェブサイトはどのような構成にすべきか
ウェブサイトをローカル(自分のコンピューター上)で作業する際は、それぞれのウェブサイトに関連するファイルをすべて単一のフォルダーにまとめておくべきです。また、すべてのウェブサイトフォルダーを 1 つの中央フォルダーにまとめておけば、どのフォルダーも簡単に探すことができるようになります。
この記事の冒頭で、すべてのウェブサイトプロジェクトを格納するための web-projects という名前のメインフォルダーを作成するよう指示しました。また、test-site という名前のサブフォルダーを作成し、その中に空の index.html ファイルを入れておくよう指示しました。
test-site 内に、一般的なウェブサイトの構造を示すために、さらにいくつかの機能を追加してみましょう。次のモジュールでは、その中に完全なウェブサイトの例を構築してもらいます。どのようなウェブサイトプロジェクトでも、最も一般的な構成要素として、index.html ファイルと、画像、スタイルシート、スクリプトファイルを格納するフォルダーが含まれます。
index.html: このファイルには、通常、ホームページのコンテンツ、つまり、ユーザーがサイトに初めてアクセスした際に表示されるテキストや画像を置きます。imagesフォルダー: このフォルダー内には、サイト上で使用するすべての画像を置きます。stylesフォルダー: このフォルダー内には、コンテンツのスタイル設定(テキストや背景色の設定など)に使用される CSS コードを置きます。scriptsフォルダー: このフォルダー内には、サイトに対話型機能を追加するために使用されるすべての JavaScript コード(例えば、ボタンがクリックされたときの動作を定義するコードなど)を置きます。
test-site フォルダー内には、すでに index.html ファイルがあるはずです。images、styles、scripts フォルダーはそこに作成してください。
ファイル名
ファイル名は通常、名前と拡張子の 2 つの部分で構成されています。先ほど作成したファイル index.html を例に挙げてみましょう。
- この場合の名前は
indexです。ファイル名には一般的に任意の文字を含めることができますが、コンピューターシステムによって使用できる文字にはさまざまな制限があります。少なくとも始める際には、数字とアルファベットのみを使用することをお勧めします。また、システムによっては特定の名前や名前の部分に対して特別な意味を付与する場合があります。すでに述べたように、indexファイルはウェブサイトのメインのホームページファイルとして認識される傾向があります。 - ファイル拡張子は、そのファイルの種類を示すものであり、コンピュータシステムが、そのファイルにどのようなコンテンツが格納されているか、どのプログラムを使用しましょうかなどを判断するために使用されます。この場合、拡張子は
.htmlであり、これはファイルにプレーンテキスト、より具体的には HTML コードが含まれていることを意味します。この拡張子があるため、コンピューターは、ファイルを開こうとした際に、デフォルトのテキストエディターを使用して開くべきであることを認識します。これまでの手順をすべて正しく実行していれば、そのデフォルトのテキストエディターは VS Code になっているはずです。
すべての場合に当てはまるわけではありませんが、ほとんどのファイルには正しく処理されるために拡張子が必要です。ファイルの拡張子を除去したり変更したりするとエラーが発生する可能性が高いため、その操作について十分に理解していない限り、変更すべきではありません。
メモ:
ファイル名に複数のドットを含めることはできます(例えば my.cats.html)。このような場合、最後のドットがファイル拡張子の先頭であるとみなされます。
Windows コンピューターでは、一部のファイルの拡張子が表示されない場合があります。これは、Windows ではデフォルトで登録されている拡張子は表示しないというオプションが有効になっているためです。この設定を無効にするには、ファイルエクスプローラーを開き、フォルダーオプション... を選択して、登録されている拡張子は表示しないのチェックボックスのチェックを外し、OK をクリックします。お使いの Windows のバージョンに関するより特定の情報網羅については、ウェブ上で検索することが可能です。
ファイル名の付け方についてのベストプラクティス
このコースを進めていくと、フォルダーやファイルの名前は常に小文字のみで、空白を含まないように指定するよう依頼していることに気づくでしょう。このアドバイスを無視すると、さまざまな課題が生じますが、特に一般的なものを以下に挙げます。
- ほとんどのウェブサーバーを初めとする多くのコンピュータシステムでは大文字と小文字が区別されます。例えば、ウェブサイトの
test-site/images/MyImage.jpgに画像を配置し、別のファイル内でtest-site/images/myimage.jpgと指定してその画像を参照しようとすると、動作しない可能性があります。 - コマンドラインでコマンドを呼び出す際、空白を含むファイル名は引用符で囲む必要があります。そうしないと、2 つの別個のアイテムとして解釈されてしまいます。
- 一部のプログラミング言語(例えば Python)では、特定の状況下(たとえば、それらのファイルがインポートされるモジュールである場合など)において、ファイル名に空白が含まれていると正常に動作しないことがあります。
- ファイル名は通常、ウェブアドレス/URL に割り当てられます。例えば、サーバーのルートフォルダーに
my file.htmlというファイルがある場合、一般的にはhttps://example.com/my%20file.htmlのようなURLでアクセスできます。ウェブサーバーは通常、ファイル名に含まれる空白を%20に置き換えます(URL は パーセントエンコーディングされるためです)。これにより、ファイル名と URL が完全に一致すると仮定している一部のシステムでは、気づきにくいバグが発生する可能性があります。
多くの開発者は、空白の代わりにハイフン (-) などの区切り文字を使用しています。例えば、my file.html ではなく、my-file.html というようにです。これは良い慣習です。
少なくとも操作に慣れるまでは、フォルダー名やファイル名を小文字で、空白を挟まず、単語をハイフンで区切って付ける習慣をつけるのが最善です。そうすれば、後々トラブルに巻き込まれることが少なくなります。
メモ: ファイル名や URL に関するその他のベストプラクティスは、Google 検索における URL 構造のベストプラクティスにあります。
ファイルパス
あるファイルから別のファイルを参照するには、ファイルパスを指定する必要があります。これは基本的に、あるファイルが別のファイルの場所を知るための経路です。例えば、画像を保有するウェブページを作成する場合、表示したい画像の場所を示すファイルパスをウェブページのコードに記述する必要があります。
それでは、この基本的な例を作成してみましょう。 現時点では、このすべてが何を意味するのか理解できないかもしれませんが、問題ありません。
- ウェブ上で気に入った画像を検索し(例えば、Google 画像検索 などのサービスを使用して)、ダウンロードしてください。あるいは、この例では、当サイトの Firefox アイコン画像をそのまま使用することもできます。
- 画像を_images_フォルダー内に配置してください。
- 画像ファイル名は、スペースをつけていない、短くて単純な名前にしてください。例えば、
firefox-icon.pngやcat.jpgは良くありますが、efregre^%^£$£@%$^&YTJgfbgfdgt54656756_ertgrth-rtgtfghhyj.pngのような名前は良くありません。同時に、ファイル拡張子は必ず残しておくようにしてください。
次に、index.html ファイルにコンテンツを追加して、画像ファイルを特定して表示することができるようにします。
-
VS Codeで
index.htmlを開き、下記に示す内容を、表示されている通りに正確にファイルに貼り付けてください。これはHTMLという、ウェブページのコンテンツを定義し、構成するために使用する言語です。これについては、まもなくさらに詳しく学んでいきます!html<!doctype html> <html lang="ja"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width" /> <title>テストページ</title> </head> <body> <img src="" alt="テスト画像" /> </body> </html> -
<img src="" alt="テスト画像">という行は、ページに画像を挿入する HTML コードです。画像がどこにあるのかを HTML に伝える必要があります。画像は images ディレクトリー内にあり、index.htmlと同じディレクトリーにあります。ファイル構造の中でindex.htmlからその画像に移動するのに必要なファイルパスはimages/your-image-filenameです。例えば、私たちの画像はfirefox-icon.pngと呼ばれており、ファイルパスはimages/firefox-icon.pngになります。 -
src=""コードの二重引用符の間の HTML コードにファイルパスを挿入してください。 -
HTML ファイルを保存してから、ウェブブラウザーで開いてください。これは、HTML ファイルを Ctrl キーを押しながら右クリックし、表示されるサブメニューから「プログラムから開く」 を選択して、ウェブブラウザーを選ぶことで実行できます。また、同時にファイルシステムの UI とウェブブラウザーウィンドウを両方開き、HTML ファイルをウェブブラウザーウィンドウの上にドラッグ&ドロップしても開くことができます。
画像を表示させるシンプルなウェブページが表示されるはずです。

ファイルパスの一般的なルールは次の通りです。
- 呼び出し元の HTML ファイルと同じディレクトリーにある対象ファイルにリンクするには、
my-image.jpgのようにファイル名を使用します。 - サブディレクトリー内のファイルを参照するには、
subdirectory/my-image.jpgのようにパスの前にディレクトリー名とスラッシュを入力します。 - 呼び出し元の HTML ファイルの上階層のディレクトリー内にある対象ファイルにリンクするには、2 つのドットを記述します。例えば、
index.htmlがtest-siteのサブフォルダー内にあり、my-image.jpgがtest-site内にある場合、my-image.jpgをindex.htmlから参照するには../my-image.jpgを使用します。 - 例えば
../subdirectory/another-subdirectory/my-image.jpgなど、好きなだけ組み合わせることができます。
メモ:
Windows のファイルシステムでは、スラッシュ (/) ではなくバックスラッシュまたは¥記号を使用します(例 : C:\Windows)。これは HTML では使用できません。Windows でウェブサイトを開発している場合でも、コード内ではスラッシュを使用する必要があります。