Before you start: find the project folder
You need the desktop version of Visual Studio Code installed on Windows, macOS, or Linux. The steps below use common features of VS Code and do not require an extension or a particular version. You also need a project folder saved on your computer. A project folder is the directory that holds the files you work on, often with smaller folders inside it.
For example, a small website project might have a folder named sample-site containing index.html, styles.css, and an images folder. Open sample-site rather than opening only index.html. That way, VS Code can show the related files together, and its file-finding tools can work across the project. If someone shared a project with you as a ZIP file, extract it first so you can select the resulting folder.
Open the folder in VS Code
Start VS Code and choose File > Open Folder. If your macOS menu instead offers File > Open, use it to select the folder. Navigate to the directory that contains your project, select the project folder itself, and confirm. You can also use the Open Folder option on the welcome screen when it appears.
VS Code may ask whether you trust the folder, especially if you downloaded it or received it from someone else. Trust only projects whose contents and source you are comfortable with. You can still inspect files without treating an unfamiliar folder as trusted. The trust prompt matters because some project features can run commands or load settings from that folder.
After opening the folder, look for its name near the top of the Explorer panel on the left. If you see only a single file and no project tree, you may have opened the file rather than its containing folder. Choose File > Open Folder again and select the parent project folder.
Browse files with the Explorer
The Explorer is the file-and-folder list in VS Code’s side bar. Select the Explorer icon in the activity bar on the far left if the list is hidden. Click the arrow beside a folder to reveal its contents, then click a file to open it in an editor tab. You can keep a file open while you browse other folders.
The names you see in the Explorer come from the folder you opened. A web project might keep page files near the top and place images, styles, or scripts in separate folders. If a file seems to be missing, first check whether its parent folder is collapsed. Then check that you opened the correct project folder; projects with similar names are easy to confuse.
Use the Explorer when you want to understand how a project is organized or when you know approximately which folder contains a file. You do not need to memorize every path. As you work, note a few important locations, such as the page you are editing and the folder that holds its styles.
Jump to a file by name
When you know a filename but not its location, use Quick Open. Press Ctrl+P on Windows or Linux, or Command+P on macOS. Start typing part of the filename, such as styles or index. VS Code shows matching files from the open project. Use the arrow keys to choose a result and press Enter to open it.
Quick Open is especially useful when a project has many nested folders. If several files share a name, read the folder path shown with each result before choosing one. Press Escape to close Quick Open without opening a file. If your expected file does not appear, check its spelling and make sure you opened the folder that contains it.
Search inside files when the name is unknown
Sometimes you remember a line of text, a CSS class, or a function name rather than the filename. Open Search with Ctrl+Shift+F on Windows or Linux, or Command+Shift+F on macOS. Enter a distinctive word or phrase and press Enter. VS Code lists matching files and shows nearby text for each match. Select a result to open the file at that location.
Start with a specific term to avoid an overwhelming list of results. For example, searching for a class name such as site-header is usually more helpful than searching for the word site. If results are missing or too broad, check the Search panel for any included or excluded file patterns and clear ones you did not intend to use. You can also use Ctrl+F, or Command+F on macOS, to search only within the file currently open.
These three methods serve different purposes: use the Explorer to learn the folder structure, Quick Open to find a file by name, and Search to find a file by its contents. If none of them finds what you expect, confirm the project folder first. The right folder is the starting point for every other step.
