Summarize this article with:
Renaming a variable across 50 files by hand? That’s a waste of time.
Learning how to find and replace in VSCode turns a 30-minute task into a 30-second operation. The built-in search widget handles everything from simple text substitution to complex regex pattern matching.
Whether you’re fixing typos in bulk, updating API endpoints, or performing project-wide refactoring, these keyboard shortcuts will speed up your workflow.
This guide covers:
- Opening the find widget and replace dialog
- Single and batch replacement methods
- Regular expressions and capture groups
- Multi-file search across your workspace
- Case sensitivity, whole word matching, and preserve case options
Works on Windows, macOS, and Linux. Takes about 3 minutes to learn.
How to Find and Replace in VSCode
Find and replace in VSCode is the process of locating specific text strings within your files and substituting them with new content using the editor’s built-in search widget.
You need this when renaming variables across a project, fixing typos in bulk, or performing code refactoring tasks.
This guide covers 5 core methods requiring about 3 minutes to learn. Works on Windows, macOS, and Linux.
Prerequisites
Before you start, make sure you have:
- Visual Studio Code version 1.80 or later installed
- A file or folder open in the editor
- Basic familiarity with keyboard shortcuts
Time needed: 2-5 minutes depending on your search complexity.
If you are new to this web development IDE, check out the basics of what VSCode is first.
How Do You Open the Find Widget in VSCode?
Press Ctrl+F on Windows/Linux or Cmd+F on macOS to open the find widget at the top right corner of your active editor window, displaying a search input field with match navigation controls.
Action
- Keyboard shortcut: Ctrl+F (Windows/Linux) or Cmd+F (macOS)
- Menu path: Edit > Find
- Result: Search widget appears with cursor in the search field
Purpose
The find widget is your starting point for any text search operation in the current file.
It supports plain text, regex patterns, and case-sensitive matching. You can also use it before learning how to comment code in VSCode to locate specific blocks.
How Do You Replace a Single Instance in VSCode?
Press Ctrl+H on Windows/Linux or Cmd+Option+F on macOS to open the replace dialog, type your search term in the first field and replacement text in the second field, then click the single replace button to substitute one match at a time.
Action
- Keyboard shortcut: Ctrl+H (Windows/Linux) or Cmd+Option+F (macOS)
- Search field: Enter the text you want to find
- Replace field: Enter the replacement text
- Click: Replace button (single icon) or press Ctrl+Shift+1
Purpose
Single replacement gives you control over each change. Useful when the same string appears in different contexts and you only want to modify specific occurrences.
I prefer this method when working with variable names that might have unintended matches elsewhere in my codebase.
How Do You Replace All Occurrences at Once in VSCode?
After opening the replace dialog with Ctrl+H, enter your search and replacement terms, then click the Replace All button (icon with double lines) or press Ctrl+Alt+Enter to substitute every matching instance simultaneously throughout the current file.
Action
- Open replace: Ctrl+H (Windows/Linux) or Cmd+Option+F (macOS)
- Enter search term: Type in the first input field
- Enter replacement: Type in the second input field
- Replace All shortcut: Ctrl+Alt+Enter or click Replace All icon
- Result: Status bar shows count of replacements made
Purpose
Batch replacement saves significant time when you need consistent changes across many lines.
Common uses include updating API endpoints, changing class names, or modifying configuration values. Just double-check the match count before confirming.
You can always press Ctrl+Z to undo if something goes wrong. Took me a while to trust that undo actually reverses all replacements in one action.
How Do You Use Regular Expressions in VSCode Find and Replace?
Click the regex toggle button (.) in the search widget or press Alt+R to enable pattern matching mode, then enter your regular expression in the search field and use capture groups like $1 in the replace field to reference matched content.
Action
- Enable regex: Click (.) icon or press Alt+R
- Search pattern: Enter regex syntax like d+ for digits or w+ for words
- Capture groups: Use parentheses () to capture, reference with $1, $2 in replace field
- Result: Matches highlight based on pattern rules
Purpose
Regex handles complex pattern matching that plain text search cannot. Renaming functions with numbered suffixes, extracting data patterns, reformatting dates.
Learning regex takes time but pays off during large-scale text manipulation tasks. Essential skill for any software development workflow.
How Do You Search Across Multiple Files in VSCode?
Press Ctrl+Shift+F on Windows/Linux or Cmd+Shift+F on macOS to open the search panel in the sidebar, where you can search and replace text across your entire workspace or filter by specific file patterns.
Action
- Keyboard shortcut: Ctrl+Shift+F (Windows/Linux) or Cmd+Shift+F (macOS)
- Menu path: Edit > Find in Files
- Files to include: Filter with patterns like .js or src/
- Files to exclude: Skip folders like nodemodules or dist
- Result: Search results panel shows matches grouped by file
Purpose
Project-wide search is critical when refactoring variable names or updating import paths across dozens of files.
The file filtering options let you target specific directories. Works great alongside source control to track what changed.
How Do You Use Case-Sensitive Search in VSCode?
Click the Match Case button (Aa icon) in the search widget or press Alt+C to toggle case sensitivity, making the search distinguish between uppercase and lowercase letters in your query.
Action
- Toggle shortcut: Alt+C
- Icon location: Aa button in search widget
- Behavior when enabled: “Test” won’t match “test” or “TEST”
Purpose
Case-sensitive mode prevents false matches in languages where casing matters. JavaScript variables, Python class names, TypeScript interfaces.
How Do You Find and Replace Using Whole Word Matching?
Click the Whole Word button (ab icon with borders) or press Alt+W to restrict matches to complete words only, preventing partial matches within larger strings.
Action
- Toggle shortcut: Alt+W
- Icon location: ab button with word boundaries in search widget
- Behavior: Searching “test” won’t match “testing” or “contest”
Purpose
Whole word matching avoids accidental replacements. Searching for “id” without this toggle would match “width”, “grid”, “video”.
I always enable this when renaming short variable names. Saves you from breaking unrelated code during bulk operations.
How Do You Preserve Case When Replacing in VSCode?
Click the Preserve Case button (AB icon) in the replace section of the search widget to maintain the original casing pattern when substituting text, automatically adjusting replacement text to match source capitalization.
Action
- Icon location: AB button in replace input area
- Behavior: Replacing “apple” with “orange” keeps “Apple” as “Orange” and “APPLE” as “ORANGE”
Purpose
Preserve case maintains consistent coding conventions without manual adjustments. Your camelCase, PascalCase, and SCREAMINGCASE stay intact.
Verification
After completing your find and replace operation, verify the changes worked correctly:
- Check the notification: Status bar displays total replacements made
- Review changed files: Modified files show a dot indicator on their tab
- Use Ctrl+Z: Undo reverts all replacements if something looks wrong
- Search again: Run the same search to confirm zero remaining matches
For multi-file replacements, the Source Control panel in the Activity Bar shows all modified files. Review the diff before committing changes to your source control management system.
Troubleshooting
Issue: Find Widget Not Appearing
Solution: Check if you have an active editor tab open. The widget only appears when a file is focused, not when viewing the Explorer or Extensions panel.
Try clicking inside a file first, then press Ctrl+F again.
Issue: Replace All Missing Occurrences
Solution: Verify your toggle settings. Case sensitivity or whole word matching might exclude valid matches.
Disable all toggles and search again. Also check if you accidentally have text selected, which limits search scope to selection only.
Issue: Search Not Finding Known Text
Solution: Check the “files to include” and “files to exclude” filters in workspace search. Your target file might be filtered out.
Clear the filter fields or add specific file extensions. Binary files and files in .gitignore are often excluded by default.
Issue: Regex Pattern Not Matching
Solution: Confirm the regex toggle is enabled (Alt+R). VSCode uses JavaScript regex syntax, which differs slightly from other flavors.
Test your pattern on a simple case first. Special characters like . and need escaping with backslashes.
Related Processes
Once you master find and replace, explore these related VSCode features:
- How to format code in VSCode for automatic styling
- How to indent multiple lines in VSCode for bulk formatting
- How to compare two files in VSCode to review changes
- How to open terminal in VSCode for command-line operations
Multi-cursor editing (Ctrl+Alt+Down) lets you type the same text in multiple locations simultaneously. Pairs well with find and replace for complex edits.
Consider learning how to use Prettier in VSCode to automate formatting after bulk replacements.
FAQ on How To Find And Replace In VSCode
What is the keyboard shortcut for find and replace in VSCode?
Press Ctrl+H on Windows and Linux or Cmd+Option+F on macOS to open the replace dialog. For find only, use Ctrl+F or Cmd+F. These shortcuts work in any open editor tab.
How do I replace all occurrences at once in VSCode?
Open the replace dialog with Ctrl+H, enter your search and replacement text, then click the Replace All button or press Ctrl+Alt+Enter. The status bar shows the total count of replacements made.
Can I use regular expressions in VSCode find and replace?
Yes. Click the regex toggle (.) or press Alt+R to enable pattern matching. Use capture groups with parentheses and reference them in the replace field using $1, $2 syntax.
How do I search across multiple files in VSCode?
Press Ctrl+Shift+F to open workspace search. Enter your query and use the “files to include” field to filter by extension or folder. Results appear grouped by file in the sidebar panel.
Why is my search not finding text I know exists?
Check your toggle settings. Case sensitivity or whole word matching may exclude valid matches. Also verify the “files to exclude” filter isn’t hiding your target file. Clear all filters and retry.
How do I make find and replace case-sensitive in VSCode?
Click the Match Case button (Aa icon) in the search widget or press Alt+C. When enabled, “Test” won’t match “test” or “TEST”. Toggle it off to ignore case differences.
What does the Preserve Case option do in VSCode replace?
Preserve Case maintains original capitalization patterns during replacement. Replacing “apple” with “orange” keeps “Apple” as “Orange” and “APPLE” as “ORANGE”. Click the AB icon to enable this feature.
How do I search within a selection only in VSCode?
Select the text block you want to search, then open find with Ctrl+F. Click the Find in Selection icon (three horizontal lines) or press Alt+L. Search scope limits to your highlighted area.
Can I undo a replace all operation in VSCode?
Yes. Press Ctrl+Z immediately after the replacement to undo all changes in one action. For multi-file replacements, each file requires a separate undo. Check the Source Control panel to review modifications.
How do I exclude folders like nodemodules from search?
In workspace search (Ctrl+Shift+F), expand the search fields and enter folder names in “files to exclude”. Type nodemodules, dist, or build separated by commas. VSCode often excludes .gitignore entries by default.
Conclusion
Knowing how to find and replace in VSCode saves hours of manual editing. The search widget handles single-file edits while workspace search tackles project-wide changes across hundreds of files.
Start with basic text substitution. Then move to regex patterns and capture groups when you need advanced pattern matching.
The toggle options matter. Case sensitivity, whole word matching, and preserve case prevent accidental replacements that break your code.
Always verify your changes. Check the match count before hitting Replace All. Use Ctrl+Z if something goes wrong.
These keyboard shortcuts become muscle memory after a few days. Ctrl+H for replace, Ctrl+Shift+F for global search, Alt+R for regex mode.
Your text manipulation tasks just got faster.
With over a decade in the tech field, Bogdan blends technical expertise with insights on business innovation in technology.
A regular contributor to TMS Outsource's blog, where you'll find sharp analyses on software development, tech business strategies, and global tech dynamics.
- Fix Bugs Faster with the Best AI Debugging Tools - January 14, 2026
- Outsourcing Salesforce Development for Enterprise Systems - January 14, 2026
- Top Mobile App Development Tools to Try - January 12, 2026
