VS Code でプロジェクトから console.log 文を削除する方法
このページの内容 6 セクション
要点:VS Code の検索で正規表現を使った「すべて置換」をすれば、1 行の単純な呼び出しは消せますが、同じ行にあるコードまで消してしまい、複数行にまたがる呼び出しは見逃します。安全に片付けるには、コメントと文字列を理解し、1 行で完結する文だけを削除するツールを使い、さらに ESLint のルールを追加して新しいものをレビューで検出しましょう。DevSnip Pro の Clean Debug Logs は、JavaScript、TypeScript、Python、Java、Kotlin、C#、Dart、Swift で前半を担います。
デバッグログは、値の正体を確かめるいちばん手っ取り早い方法です。問題は後片付けです。消し忘れた console. はブラウザーのコンソールにデータを漏らし、残った print は本番のログを埋め、コミットのたびに手で探すのは面倒です。
Ctrl/Cmd+Shift+H でファイル横断の検索を開き、. ボタンで正規表現を有効にして、次を検索します:
^[ \t]*console\.log\([^;\n]*\);?[ \t]*\nReplace は空のままにし、サイドバーで一致箇所を確認してから置換します。このパターンは行全体を占める呼び出しにだけ一致し、最初のセミコロンで止まるので、同じ行のログの後ろにあるコードを消すことはありません。その代わり、; を含むログ(文字列の中など)はスキップされます。
それでも限界があります:
console.のような複数行の呼び出しには一致しないので、残ってしまいます。log(\n user,\n order\n) - コメントや文字列にも一致します。テンプレートリテラル内の行や、コメントアウトした例が消えてしまいます。
- 空のブロックが残ることがあります。Python では、
ifの本体にある唯一のprintを消すと構文エラーになります。 - 1 回の検索で扱えるのは 1 つの言語と 1 つの関数名だけです。
files to include フィールド(src/ など)を使って、node_modules、生成されたファイル、取り込んだサードパーティのコードを対象から外しましょう。
コマンドパレット(Ctrl/Cmd+Shift+P)から DevSnip Pro: Clean Debug Logs を実行します。ワークスペースをスキャンし、何かを変更する前に見つかったものを一覧表示します:
console.、log print、pprint、breakpoint()、System.、out. println Log.、d Console.、WriteLine Debug.、WriteLine debugPrint、NSLog、dumpなどの呼び出し。HTML、Vue、Svelte、PHP ファイルの<script>ブロックも対象です。- コメントや文字列の中の呼び出しは無視されます。
- 1 行で完結する文だけが削除されます。ほかのコードと同じ行にある呼び出し、式の続き、波括弧のない
ifの本体になっている呼び出しは、削除されずに確認用として一覧表示されます。 - コードは有効なまま保たれます。空になった Python のブロックには
pass、空になった Swift や Dart のcaseにはbreakが入ります。改行コードも保持されます。
削除前に確認が入ります。設定 devsnip. で制御できます。今開いているファイルだけなら Remove Debug Logs in This File を実行し、気が変わったら Undo で元に戻せます。
本来のロギングは安全です。プロジェクトのロガーを通した呼び出し(logger.、_logger. など)は、DevSnip Pro 自身が書いたものでない限り触れられません。
後片付けの問題の半分は、本物のコードに見えてしまうログです。Insert Debug Log(Ctrl+Alt+Shift+L)は、カーソル位置の変数を [file:line] のラベル付きで、適切な場所にログ出力します。代入の後、引数なら関数の先頭、ループ変数ならループの先頭です。
const total = items.reduce((sum, item) => sum + item.price * item.qty, 0);
console.log('[cart.ts:14] total:', total);ファイルにすでにロガーがあれば、print や console. の代わりにそれを使います:
total = sum(item.price * item.qty for item in items)
logger.debug("[orders.py:12] total=%r", total)挿入したログにはすべてラベルが付いているので、プロジェクトのロガーを通していても、Clean Debug Logs があとで認識して削除できます。
クリーンアップツールが直すのは今日のログ、lint のルールが止めるのは明日のログです。ESLint のフラット設定なら:
// eslint.config.js
export default [
{
rules: {
'no-console': ['warn', { allow: ['warn', 'error'] }],
},
},
];これは console. を指摘し、意図的なことが多い console. と console. は許可します。CI で ESLint を実行すれば、残ったログは本番に届く前にチェックで落ちます。Python のプロジェクトでは、Ruff の T20 ルール(flake8-print)で同じことができ、print と pprint を指摘します。
バンドラーやミニファイアーは、本番ビルドからコンソールの呼び出しを取り除けます。たとえば esbuild の drop オプションや Terser の drop_console です。配布するバンドルには入らなくなりますが、ソースやコードレビューには残ったままです。クリーンアップと lint のルールの代わりではなく、それに加える安全網として使うのが最適です。
- ラベル付きのログ(Insert Debug Log)でデバッグし、ひと目でわかるようにします。
- コミット前に Clean Debug Logs を実行し、一覧を読み、削除されずに指摘されたものを確認します。
- すり抜けたものは、CI で ESLint や Ruff に捕まえてもらいます。