VS Codeで保存時に自動整形されない原因と設定の直し方

VS Codeで保存時に自動整形されない原因と設定の直し方 不具合・バク
スポンサーリンク

Ctrl+Sを押しても、HTMLやJSONの字下げがそろわず困っていませんか?保存時の設定を変える前に、手動の「ドキュメントのフォーマット」が動くかを確認します。手動でも整形できない状態と、保存時だけ動かない状態では見る場所が違うためですね。Windows版VS Codeを例に、元のコードを残しながら調べる手順を紹介しますね。

▶本記事の概要

  • 手動の整形が動くかを最初に試す
  • 保存時の整形と既定の担当を設定する
  • フォルダーと言語ごとの設定差を調べる
  • エラーを読みながら小さいファイルで再確認する
  • まとめ
  • 言語モードと対象ファイルを確認する
  • コマンドから一度だけ整形する

手動の整形が動くかを最初に試す

言語モードと対象ファイルを確認する

右下の言語モードを見て、HTMLを編集しているのに「プレーンテキスト」になっていないか確認してください。拡張子が.txtのままだと、想定した整形機能が選ばれない場合があります。実際の内容に合う言語へ切り替えて試したいですね。

最初は既存ファイルのコピーを使います。公開中のページや共有リポジトリで、全体のインデントが一度に変わると確認しにくくなるためですね。名前の似たファイルを複数開いている時は、タブに表示されるパスも見ましょう。

コマンドから一度だけ整形する

Ctrl+Shift+Pでコマンドパレットを開き、「Format Document/ドキュメントのフォーマット」を実行してください。Windowsの標準ショートカットはShift+Alt+Fですが、割り当てを変更している場合はコマンドからの実行が分かりやすいです。

  • 手動で整う:保存時の設定へ進む
  • フォーマッターがない:対象言語の対応を確認
  • 複数候補が出る:使いたいものを一つ選択
  • 構文エラーが出る:指摘された位置を修正

資料を開くたびタブが入れ替わる場合の対処法はこちらから確認できますね。

  • Format On Saveを有効にする
  • 既定のフォーマッターを選び直す

保存時の整形と既定の担当を設定する

Format On Saveを有効にする

設定画面で「editor.formatOnSave」を検索し、対象の設定を有効にしてください。その後、試験用ファイルの字下げを少し崩し、Ctrl+Sで明示的に保存します。自動保存のタイミングも混ぜると判断しにくいため、まず手動保存で結果を見たいですね。

整形前から正しい形式なら、保存しても見た目が変わらないことがあります。空白の違いが分かる短いサンプルで確認すると、動いていないのか、変更の必要がないのかを区別できますね。

既定のフォーマッターを選び直す

コマンドパレットで「Format Document With…」を選び、既定のフォーマッターを構成する項目から担当を指定してください。複数の拡張機能が同じ言語を扱う環境では、どれを使うかが曖昧な場合があります。拡張機能をまとめて削除する前に、この選択を確かめたいですね。

言語ごとに担当が違っていても問題ありません。HTMLは内蔵機能、別の言語は対応拡張という構成もあります。インストール済みというだけで、そのファイルの整形を担当できるとは限らない点に注意してください。

  • ユーザー設定とワークスペース設定を比較する
  • 言語別設定と整形範囲を確認する

フォルダーと言語ごとの設定差を調べる

ユーザー設定とワークスペース設定を比較する

一つのフォルダーだけ動かないなら、設定画面の「ユーザー」と「ワークスペース」を切り替えて同じ項目を確認してください。全体で有効でも、作業フォルダー側に別の指定があるかもしれません。リモート環境や複数フォルダーのワークスペースでは、対象の範囲も見たいですね。

共有設定を変更すると、ほかの人の作業ルールに影響することもあります。まず現在の設定値を控え、テスト用のフォルダーで比較してください。直った値を見つけても、設定ファイル全体を消す必要はありません。

言語別設定と整形範囲を確認する

「」などの言語別設定に、Format On SaveやDefault Formatterの指定がないかも確認します。ほかのファイルは整うのに一種類だけ動かない時に有効な切り分けですね。設定画面の言語フィルターを使うと探しやすいですね。

変更した行だけを整形する設定では、触っていない箇所が残ることがあります。全体の整形を期待しているなら「editor.formatOnSaveMode」の値も確認しましょう。ただし、部分整形への対応はフォーマッターによって異なります。

同じフォルダーのファイルが検索結果に出ない時の確認方法はこちらから確認できますね。

  • 拡張機能の出力と構文エラーを見る
  • 修正と整形を混ぜず差分を確認する

エラーを読みながら小さいファイルで再確認する

拡張機能の出力と構文エラーを見る

エラー通知が出る場合は、その文面を先に読んでください。閉じ括弧の不足や設定ファイルの問題で止まっているなら、保存の設定だけを変更しても改善しません。必要に応じて「表示→出力」で対象の拡張機能のログを選ぶと、理由が見つかることがありますね。

動作確認は、秘密情報を含まない短いコードで行います。外部サイトへ丸ごと貼り付けなくても、ローカルの小さいファイルで再現するかを確認できますね。特定のプロジェクトだけなら、その設定や除外指定を次に調べましょう。

修正と整形を混ぜず差分を確認する

整形後は、字下げだけでなくコードの意味が変わっていないか確認してください。保存時の自動修正など、フォーマットとは別の処理が同時に動く場合もあります。Gitを利用しているなら差分を読むと、何が変わったかを追いやすいですね。

最後にファイルを閉じて開き直し、設定が維持されているか試します。再発する場合は言語、担当拡張、設定範囲、エラー文の四点を記録しましょう。原因が不明なままsettings.json全体を削除する方法は避け、関係する項目から調整してください。

例えばHTMLだけ整い、CSSでは何も変わらない場合、保存ボタン全体の故障とは考えにくい状況です。CSSファイルを開いた状態で言語モードと担当フォーマッターを確認しましょう。逆に同じHTMLでもフォルダーAでは整い、フォルダーBでは整わないなら、ワークスペース側の指定が比較材料になりますね。成功するファイルを上書きして試すのではなく、短いコピーを両方へ置いて同じ内容で比べると分かりやすいです。差が出た設定だけを調整すれば、普段使っているテーマやショートカットまで戻す必要はありません。

まとめ

保存時の自動整形は、手動整形が動く状態を作ってから設定すると整理しやすいです。担当フォーマッターと言語・フォルダーごとの差を確認したいですね。

▶本記事の振り返り

  • 手動整形の結果で確認先を分ける
  • Format On Saveと既定の担当を確認
  • 言語別とワークスペース設定を比較
  • 整形後の差分を読む

参考資料(確認日:2026年11月18日)

コメント