Visual Studio Codeで行の折り返しを設定する方法

Visual Studio Codeのアクティブなテキストエディターでは、Alt+Z(macOSでは⌥+Z)で行の折り返しを切り替えられます。折り返しの設定を保存するには、設定画面でeditor.wordWrapを変更します。

編集中のエディターで折り返しを切り替える

対象のテキストエディターを選び、同じショートカットをもう一度押すと折り返しのオンとオフが切り替わります。コマンドパレットからView: Toggle Word Wrapを実行することもできます。表示言語によってコマンド名は翻訳されます。

この操作で変わるのはアクティブなエディターの表示です。長い行は画面上で複数行に分かれて表示されますが、ファイルの内容と行番号はそのままです。

VS Code公式ドキュメントの行の折り返し

折り返しの設定を保存する

  1. Ctrl+,(macOSでは⌘+,)で設定を開きます。
  2. @id:editor.wordWrapを検索します。
  3. エディターの幅に合わせるならonを選びます。列の上限を使う場合は、下の表からモードを選びます。

Userタブの設定は現在のプロファイルに保存されます。プロジェクトに適用する場合は、ワークスペースを開いた状態でWorkspaceタブを選びます。

VS Code公式ドキュメントの設定の優先順位

4つのモードの違い

設定値 動作
off 自動で折り返しません。長い行は横スクロールで確認できます。初期値です。
on エディターの利用可能な幅に合わせて折り返します。
wordWrapColumn editor.wordWrapColumnで指定した列を基準に折り返します。初期値は80です。
bounded エディターの利用可能な幅と指定した列のうち、狭い方を基準に折り返します。

特定の列に縦の目安線を表示するには、editor.rulersを使います。折り返す位置は選択したモードで決まります。

最大88列で折り返す設定例

ユーザー設定を直接編集するには、コマンドパレットでPreferences: Open User Settings (JSON)を実行します。すでに設定がある場合は既存のJSONオブジェクトに2項目を追加し、項目間のカンマを確認します。

{
  "editor.wordWrap": "bounded",
  "editor.wordWrapColumn": 88
}

長い行のあるファイルを開き、エディターの幅を狭めます。表示領域が88列分より狭くなると、より手前で折り返されます。単語の区切りやタブの表示幅によって、画面上の折り返し位置が変わることがあります。

設定が反映されないときの確認とリセット

ファイルごとに表示が異なる場合は、ワークスペース設定や[markdown]などの言語別設定を確認します。一つのエディターだけ表示が違う場合は、Alt+Zまたは⌥+Zで一時的な折り返しを切り替えてみてください。

設定項目の歯車メニューからReset Settingを選ぶと、その設定をリセットできます。JSONで編集した場合は、同じ設定スコープから変更した項目を削除します。