【VSCode】複数ファイルの文字列を一括置換する方法|検索と置換の使い方

みなさんこんにちは。

VSCodeで複数のファイルを編集していると、同じ文字列をまとめて変更したいと思った経験をしたことがある方も多いかと思います。ファイルを1つずつ開いて置換するのは、なかなか手間がかかりますよね。

今回は、VSCodeの検索と置換機能を使って、複数ファイルの文字列を一括置換する方法についてご紹介したいと思います。拡張機能は必要ありません。

今回使用するサンプルファイル

確認用のフォルダーを作成し、次の3つのJavaScriptファイルを保存してください。今回は、どのファイルにも旧メッセージという文字列を入れています。

// app.js
function startApp() {
    console.log("旧メッセージ");
}
startApp();

// logger.js
export function logStart() {
    console.log("旧メッセージ");
}

// status.js
export const statusText = "旧メッセージ";

上記は説明用にまとめて表示していますが、実際にはapp.js・logger.js・status.jsの3ファイルに分けて保存してください。VSCodeの「ファイル」→「フォルダーを開く」から、そのフォルダーを開きましょう。

複数ファイルを検索する

VSCodeでCtrl + Shift + Hを押すと、複数ファイルを対象にした検索と置換の画面が開きます。検索欄に旧メッセージと入力してください。

今回のサンプルでは、3つのファイルから計3件が検索結果に表示されるはずです。Ctrl + Hは主に開いているファイル内の置換なので、使い分けましょう。

VSCodeで複数のJavaScriptファイルから旧メッセージという文字列を検索し3件の結果を表示した画面

置換後の文字列を入力する

検索欄の下にある置換欄に、今回は処理を開始しましたと入力しましょう。置換候補が表示されたら、各ファイルの変更内容を確認してから一括置換を実行してください。

右側の検索結果をクリックすると該当箇所を確認できます。検索結果の差分表示も利用し、意図しない文字列まで置き換わらないか確認すると安心ね。

VSCodeの複数ファイル一括置換画面で検索文字列と置換文字列を指定しReplace Allの実行前に確認する画面

すべて置換して実行結果を確認する

置換欄の横にある「すべて置換(Replace All)」を実行します。確認ダイアログが表示された場合は、対象件数を確認してから進めてください。

完了後、旧メッセージで再検索して0件になることを確認しましょう。続いて処理を開始しましたで検索すれば、3ファイルに変更内容が反映されていることを確認できます。

VSCodeで複数のJavaScriptファイルの旧メッセージを処理を開始しましたに一括置換した後の検索結果

対象ファイルを絞る方法と注意点

ファイル数が多い場合は、検索詳細の「含めるファイル」に*.jsを指定すると、JavaScriptファイルに対象を絞れます。また「除外するファイル」には、必要に応じて**/node_modules/**などを指定してください。

一括置換は複数のファイルを書き換えるため、実行前に変更内容を確認し、可能であればGitなどで元の状態を残すことをおすすめします。ファイル名や拡張子を変更する機能ではなく、ファイル内の文字列を置換する機能である点にも注意してください。

最後に

いかがでしたでしょうか。今回は、VSCodeで複数ファイルの文字列を一括置換する方法をご紹介しました。Ctrl + Shift + Hを使用すれば、複数のファイルを開き直さずに検索・置換できます。少しでも参考になれば幸いです。

開発依頼について

ココナラでWebスクレイピング開発サービスを出品しております。

自分で開発をしようと思ったけど、VBAでのネット記事が少なく困っている方も多いかと思います。

そんな方はいつでもお気軽にご相談ください。

また、本ブログからご依頼いただいた方については割引特典がございますので、

ご不明点と合わせてメッセージをいただけると幸いです。

業務の流れをまるごと自動化します Excel・Web・Teams・SaaSで業務全体を自動化

Webスクレイピング以外にもWebアプリの開発サービスも出品しております。

こちらについても、本ブログからご依頼いただいた方については割引特典がございますので、

お気軽にご相談ください。

スモールスケールのWebアプリ開発します 先ずはスモールスケールのWebアプリから始めませんか?

ご興味がある方はこちら!!

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

CAPTCHA