メインコンテンツにスキップ

VSCode Tips and Settings

vscode
作者

Ryo Nakagami

公開

2026-08-21

更新日

2026-10-24

1. Editing

1.1: 行・ブロックの移動

ノートRule 1-1: 複数行をまとめて上下に動かすときは Shift 選択 → Alt + ↑/↓
  • Shift + ↑/↓ で移動させたい行を範囲選択する
  • Alt を押しながら ↓/↑ で選択範囲ごと移動する
  • 選択範囲は移動後も保持されるので,Alt + ↓ を連打して任意の位置まで送れる
  • 1行だけ動かす場合は範囲選択不要で Alt + ↑/↓ のみでよい
# before: バリデーションが計算の後に来てしまっている
def process(records):
    total = sum(r["amount"] for r in records)
    if not records:                          # <- この2行を選択して
        raise ValueError("empty records")    # <- Alt + ↑ を2回
    return total
command 動作 comment
Alt + ↑/↓ カーソル行 or 選択範囲を上下に移動 インデントは移動先の文脈に合わせて自動調整される
Shift + Alt + ↑/↓ カーソル行 or 選択範囲を上下に複製 移動ではなくコピー

系 1.1.1: 離れた行への転記

  • Alt + ↑/↓ は隣接行の入れ替えには強いが,「line 30 のブロックを line 100 に移したい」のように距離があるときは連打が非効率
  • この場合は 切り取り → ジャンプ → 貼り付け の3ステップに分けるほうが速い
ノートRule 1-2: 遠くへ動かすときは Ctrl + X → Ctrl + G → Ctrl + V
  • Ctrl + X: 選択範囲(未選択ならカーソル行全体)を切り取る
  • Ctrl + G: Go to Line 入力を開き,行番号(例 100)を入れて Enter でジャンプ
  • Ctrl + V: 貼り付け

Ctrl + G は行番号だけでなく 100:5(100行5桁目)の形式も受け付ける. また Ctrl + P のQuick Openで filename.py:100 と打てば,別ファイルの特定行へ直接飛べるので,ファイル間の転記にも同じ手順が使える.

command 動作 comment
Ctrl + G 指定行へジャンプ :区切りで桁指定も可能
Ctrl + Home/End ファイル先頭/末尾へ移動

2. 移動

2.1: Directory 作成後の Explorer でのフォーカス

ノートRule 2-1: Explorer で特定のディレクトリにフォーカスしたいときは,ターミナル上のパスを Ctrl + クリック
  • VS Code の統合ターミナルは出力中のファイル・ディレクトリのパスをリンクとして検出する
  • 下の例なら pwd の出力に出てきた絶対パスを Ctrl + クリックする
  • ワークスペース内のディレクトリであれば,Explorer でそのディレクトリが展開・選択された状態になる

ターミナルで新しいディレクトリを作って cd したあと,Explorer でもそのディレクトリを開きたいことがあります. Explorer のツリーを上から辿るのは手間なので,ターミナルに表示されているパスをそのまま使えば,Explorer でフォーカスできます.

% mkdir 2026-10-17-python-backend-build
% cd !^
cd 2026-10-17-python-backend-build
% pwd
/home/hogehoge/posts/2026-10-17-python-backend-build # ← これをctrl + click

2.2: VSCode workspaceからHTMLファイルをデフォルトブラウザで開く

ノートRULE 2-2: VSCode内のターミナルからコマンド経由で開く
# Mac
open index.html

# Linux
xdg-open index.html  # openコマンドでもok
  • xdg-open とは,ファイルやURLを,ユーザーが設定したデフォルトアプリケーションで開くコマンド
xdg-open index.html              # HTMLファイル → デフォルトブラウザ
xdg-open report.pdf              # PDF → デフォルトのPDFビューア
xdg-open .                       # ディレクトリ → ファイルマネージャー
xdg-open https://quarto.org      # URL → デフォルトブラウザ

なぜLinuxでも open コマンドで開けるのか?

Ubuntuでは /usr/bin/open がalternativesシステム経由で xdg-open へのシンボリックリンクになっています.

% ls -l $(which xdg-open)
-rwxr-xr-x 1 root root 26075 Aug  1  2022 /usr/bin/xdg-open*

% ls -l $(which open)
lrwxrwxrwx 1 root root 22 Jul 15  2023 /usr/bin/open -> /etc/alternatives/open*

% ls -l /etc/alternatives/open
lrwxrwxrwx 1 root root 17 Jul 15  2023 /etc/alternatives/open -> /usr/bin/xdg-open*
  • open → /etc/alternatives/open → /usr/bin/xdg-open の順にリンクが辿られ,最終的に xdg-open が実行される
  • xdg-open はファイルの種類(MIME type)に応じて,デスクトップ環境で設定されたデフォルトアプリケーションで開くコマンド.HTMLファイルならデフォルトブラウザが起動する

3. Settingsの観点

General

ノートRule 3-1: 「探さないもの」は search.exclude,「見張らないもの」は files.watcherExclude に登録する
  • search.exclude: 全文検索・Quick Open(Ctrl + P)の走査対象から外す
  • files.watcherExclude: ファイル変更監視(file watcher)の対象から外す
  • どちらも glob パターンをキー,true を値にして指定する
設定 除外されるもの Explorer 表示 comment
files.exclude Explorer 表示・検索の両方 非表示 ファイルの存在自体を隠したいとき用.検索からも外れる
search.exclude 全文検索・Quick Open 表示される ファイルは開けるが検索には出てこない
files.watcherExclude ファイル変更監視 表示される 外部プロセスによる変更が Explorer やエディタに自動反映されなくなる

search.exclude の効能

"search.exclude": {
  "data/**": true,
  "**/*.parquet": true
}

この設定をすると

  • Cmd+Shift+F で user_id を検索しても,data/train.csv などの一致は結果に出ず,コードの一致だけが並ぶ
  • data/ 配下や .parquet ファイルを走査しなくなるので,検索が速くなる
  • Cmd+P(Quick Open)の候補からも外れる
  • エクスプローラーには表示されたままで,クリックすれば開ける

なお,search.useIgnoreFiles が true(デフォルト)なら,.gitignore に書いたパスは指定しなくても検索から外れてます.gitignore していないファイルを検索から外したいときにだけ設定します.

files.watcherExclude の効能

"files.watcherExclude": {
  "data/**": true,
  "mlruns/**": true,
  "outputs/**": true
}

この設定をすると

  • 学習ジョブが mlruns/ に大量にログを書き込んでも,VS Code がその変更イベントを処理しなくなり,CPU やメモリの消費が抑えられる
  • data/ に数万ファイルがあっても,監視上限の警告(Linux の inotify 上限など)が出にくくなる
  • outputs/ に新しいファイルができてもエクスプローラーにすぐ出てこない(更新ボタンで反映)

なお,.gitignore に書いてあっても監視はされるので,監視を止めたい場合は明示的に記載することが必要です

Python

カテゴリー 項目 設定値 挙動
Jupyter jupyter.notebookFileRoot "${fileDirname}" Notebook / Interactive Window のカーネルの作業ディレクトリを,開いているファイルのディレクトリにする.相対パスでの open() や read_csv() はファイル位置基準で解決される
Jupyter jupyter.interactiveWindow.creationMode "perFile" # %% セル実行時の Interactive Window を .py ファイルごとに1つ作る.ファイル間でカーネル・変数は共有されない
Terminal python-envs.terminal.autoActivationType "off" 新しいターミナルを開いても venv を自動 activate しない(uv run 運用前提)
Pylance python.analysis.ignore ["**/Interactive-*.interactive.py"] Interactive Window が内部生成する一時ファイルに対して Pylance の診断を出さない
Pylance python.analysis.diagnosticSeverityOverrides { "reportAssignmentType": "warning" } 宣言型と互換性のない代入を error ではなく warning として表示する
Formatter [python] > editor.defaultFormatter "charliermarsh.ruff" Python ファイルの「ドキュメントのフォーマット」で Ruff を使う

4. Extensions

Editorconfig

ノートRule 4-1: .editorconfig を VS Code に効かせるために EditorConfig 拡張(EditorConfig.EditorConfig)を入れる
  • VS Code は .editorconfig をネイティブには読まないので,拡張を入れないとリポジトリに .editorconfig を置いても無視される
  • 拡張を入れると,ファイルを開いた・保存したタイミングで .editorconfig の改行コード・インデント・末尾改行などの設定が適用される
  • 既存の settings.json(files.eol や editor.tabSize など)よりも .editorconfig の値が優先される

VS Code はネイティブ対応していない

  • EditorConfig 公式サイト には「No Plugin Necessary」というセクションがあり,「These editors come bundled with native support for EditorConfig.」としてネイティブ対応のエディタが一覧になっている
  • Visual Studio Professional・Vim・Neovim・JetBrains 系の IDE などは含まれているが,VS Code は含まれていない
  • VS Code は「Download a Plugin」側に分類されており,.editorconfig を効かせるには EditorConfig 拡張(EditorConfig.EditorConfig)のインストールが必要

なぜ設定するのか?

  • OS やエディタ設定の違いによる書き方のゆらぎを,リポジトリ側のルールとして固定できるため

例えばリポジトリのルートに次のような .editorconfig を置きます.

# top-most EditorConfig file
root = true

# Unix-style newlines with a newline ending every file
[*]
end_of_line = lf
insert_final_newline = true

# Matches multiple files with brace expansion notation
# Set default charset
[*.{js,py}]
charset = utf-8

# 4 space indentation
[*.py]
indent_style = space
indent_size = 4

この設定をすると

  • end_of_line = lf: Windows のエディタはデフォルトで改行コードを CRLF にしがちだが,Windows・Mac・Linux のどこで編集しても LF に揃う
  • insert_final_newline = true: 保存時にファイル末尾へ改行が入るので,人によって末尾改行があったりなかったりする状態がなくなる
  • charset = utf-8: .js・.py の文字コードが UTF-8 に揃い,Windows 環境で Shift_JIS などで保存されて文字化けする事故を防げる
  • indent_style = space / indent_size = 4: .py のインデントが4スペースに揃い,タブとスペースの混在が起きない

editorconfigを導入しないデメリット

ゆらぎを放置すると,不要な git diff が発生します.

  • 1行しか直していないのに,改行コードが CRLF ↔︎ LF で変わったせいでファイル全行が差分として表示される
  • 末尾改行の有無が変わるたびに \ No newline at end of file の差分が出る
  • インデントのタブ・スペースが変わると,見た目は同じなのに行全体が変更扱いになる

markdownlint

ノートRule 4-2: markdownlint 拡張(DavidAnson.vscode-markdownlint)は使わない
  • 執筆中に lint の warning が常に表示され,内容を書くことへの集中が削がれる
  • 編集のたびに lint が走るので,CPU・メモリのリソース負荷がかかる
  • 既にインストール済みなら,Extensions ビュー(Ctrl + Shift + X)から Uninstall または Disable する

warning が busy で集中が切れる

  • markdownlint は見出し前後の空行,行長,リストのインデント,HTML タグの使用などを細かくチェックし,該当箇所に波線を引いて Problems パネルに warning を並べる
  • 文章を書いている最中に波線や Problems の件数が目に入ると,つい体裁の修正に手が止まり,内容を考える思考が途切れる
  • 体裁は レンダリング結果を見て確認すれば十分で,執筆中にリアルタイムで指摘される必要はない

lint によるリソース負荷

  • markdownlint はデフォルトで入力のたびに(markdownlint.run: "onType")開いている Markdown ドキュメントを再解析する
  • lint 処理は Extension Host プロセス上で動くため,長い記事を書いているときや複数ファイルを開いているときは,その分 CPU・メモリを消費する
  • Extension Host が重くなると,補完や他の拡張機能の応答も遅くなる

どうしても lint を使いたい場合は,"markdownlint.run": "onSave" にして保存時だけ走らせると,入力中の warning 表示と負荷はある程度抑えられる.

Appendix : xdg-open の動作

xdg-open 自体はファイルを開く処理を持たず,「どのデスクトップ環境か」を判定したうえで,そのデスクトップ環境のコマンドに処理を委譲します.GNOME(Ubuntuの標準)の場合の流れは以下

xdg-open index.html からブラウザが起動するまでの流れ(GNOMEの場合)
Step 処理 内容
1 xdg-open の実行 /usr/bin/xdg-open が引数のファイルパスを受け取る
2 デスクトップ環境の判定 環境変数 $XDG_CURRENT_DESKTOP(例: ubuntu:GNOME)を見て,GNOME / KDE / Xfce などを判定する
3 コマンドへの委譲 GNOMEなら gio open,KDEなら kde-open のように,デスクトップ環境ごとのコマンドを呼ぶ.どれにも該当しなければ xdg-open 自身の汎用処理(open_generic)で開く
4 MIME typeの判定 拡張子やファイルの中身から,text/html のようなMIME typeを判定する
5 デフォルトアプリの検索 ~/.config/mimeapps.list などから,MIME typeに対応する .desktop ファイル(例: firefox.desktop)を探す
6 アプリの起動 .desktop ファイルの Exec= に書かれたコマンドに,ファイルパスを渡して実行する

デフォルトアプリの確認と変更

Step 4・5で何が選ばれるかは xdg-mime コマンドで確認・変更できます.

# Step 4: ファイルのMIME typeを確認
% xdg-mime query filetype index.html
text/html

# Step 5: MIME typeに対応するデフォルトアプリを確認
% xdg-mime query default text/html
google-chrome.desktop

# デフォルトアプリを変更(~/.config/mimeapps.list に書き込まれる)
% xdg-mime default firefox_firefox.desktop text/html

References