--- title: "Managing LaTeX Clutter in Visual Studio Code" date: 2026-03-10T00:00:00.000Z author: Z.SHINCHVEN tags: [LaTeX, Visual Studio Code, Productivity] canonical: https://atlassc.net/2026/03/10/managing-latex-clutter-in-visual-studio-code --- # Managing LaTeX Clutter in Visual Studio Code When working with LaTeX in Visual Studio Code, one of the most immediate frustrations is the sheer volume of auxiliary files generated during the compilation process. While these files are vital for the LaTeX engine to produce a final PDF, they quickly overwhelm the file explorer, making it difficult to locate your actual source files. In this document, we explore the nature of this problem in detail and explain the precise steps we took to resolve it, detailing the differences between user and workspace settings in Visual Studio Code. ## The Challenge of LaTeX Compilation Files LaTeX is not a simple word processor; it is a complex document preparation system. When compiling a document, tools like pdfLaTeX, XeLaTeX, or latexmk perform multiple passes to resolve cross references, generate bibliographies, and build tables of contents. Each of these passes produces intermediate files. A standard compilation might generate the following files alongside your main `.tex` document: * `.aux` files storing cross reference information * `.log` files containing detailed output from the compiler * `.out` files holding data for hyperref bookmarks * `.toc` files containing data for the table of contents * `.synctex.gz` files enabling synchronization between the source code and the PDF viewer * `.fls` and `.fdb_latexmk` files used by latexmk to track dependencies and compilation states * `.bcf`, `.bbl`, `.blg`, and `.run.xml` files generated by bibliography processors like Biber or BibTeX While these files are essential for the build system, they are not meant to be edited manually. Having them visible in the Visual Studio Code file explorer creates visual noise and reduces productivity. The goal is to hide these files from the user interface while keeping them intact on the file system. ## The Solution: Visual Studio Code Settings Visual Studio Code provides a powerful mechanism for controlling file visibility through the `files.exclude` setting. This setting accepts an object where keys are glob patterns matching file paths and values are boolean flags indicating whether those files should be hidden. There are two primary scopes where this setting can be applied: User Settings and Workspace Settings. ### User Settings User settings apply globally to every instance of Visual Studio Code opened by the user. If you configure `files.exclude` in your user settings, the specified files will be hidden in every single project you open. This is convenient if you use your computer exclusively for LaTeX development. However, it can be problematic for developers who work across multiple languages. For instance, hiding all `.log` files globally might obscure important log files in a Node.js or Python project, leading to confusion when debugging other applications. ### Workspace Settings Workspace settings, on the other hand, apply strictly to the currently opened folder or workspace. These settings are stored in a dedicated `.vscode/settings.json` file located at the root of the project directory. This approach offers distinct advantages: * **Isolation**: Settings configured here do not leak into other projects. Your Python or JavaScript projects remain unaffected. * **Portability**: The `.vscode` directory can be committed to version control. This ensures that any collaborator opening the repository automatically benefits from the same clean file explorer configuration without needing to adjust their personal user environment. * **Granularity**: You can tailor the exclusion rules specifically to the needs of the individual project. ## What We Did: Applying the Workspace Solution Given the advantages of isolation and portability, we chose to implement the solution at the workspace level for this specific resume project. Here is the exact process we followed together: 1. **Creating the Configuration File**: We created a new directory named `.vscode` at the root of the project directory. Inside this directory, we created a file named `settings.json`. 2. **Defining the Exclusion Rules**: We populated the `settings.json` file with a comprehensive set of glob patterns targeting standard LaTeX auxiliary extensions. The configuration block we applied looks exactly like this: ```json { "files.exclude": { "**/*.aux": true, "**/*.log": true, "**/*.out": true, "**/*.toc": true, "**/*.synctex.gz": true, "**/*.fdb_latexmk": true, "**/*.fls": true, "**/*.bbl": true, "**/*.blg": true, "**/*.bcf": true, "**/*.run.xml": true, "**/*.lof": true, "**/*.lot": true, "**/*.idx": true, "**/*.ilg": true, "**/*.ind": true } } ``` 3. **Immediate Effect**: Visual Studio Code monitors the `.vscode/settings.json` file for changes. The moment the file is saved, the file explorer immediately refreshes, hiding all files that match the defined patterns. The actual files are not deleted; they remain safely on the disk to facilitate fast incremental compilations, but they no longer clutter the editor interface. ## Extending the Concept to Search While the `files.exclude` setting hides files from the explorer, it is also worth noting that Visual Studio Code has a complementary setting called `search.exclude`. By default, files hidden from the explorer are also excluded from search results. This means that when you perform a global text search across your project, Visual Studio Code will not waste time scanning through compiler logs or auxiliary data, yielding faster and more relevant search results. ## Conclusion By meticulously defining file exclusion rules in a workspace scoped settings file, we successfully transformed a cluttered project directory into a clean, focused environment. This approach leverages the best practices of Visual Studio Code configuration, ensuring that the development environment is optimized for LaTeX authoring while preserving the integrity of other software projects on the same machine.