Working Effectively with VS Code
A practical VS Code guide from project setup to navigation, debugging, formatting, linting, and remote work.
Complete real work with VS Code
This site's maintained VS Code documentation aims to make a change reproducible from project setup and navigation through debugging, refactoring, formatting, linting, Git review, and remote development.
Start with navigation if new to VS Code, or choose the guide for the task at hand. Language guides use independent learning projects; the formatting tutorials share format-lab. Do not overwrite one project's settings with every alternative example.
Find documentation by task
| Task | Guide | Completion evidence |
|---|---|---|
| Start editing and navigating | Project setup and refactoring | Find callers, rename, and pass tests |
| Work on Java services | Java and Spring Boot | Align JDKs, import, and JUnit debugging |
| Work on web or Node code | TypeScript | Inspect compiler, service, and source maps |
| Work on Go services | Go, gopls, and Delve | Debug a test and reproduce CLI checks |
| Work on Python | Python, pytest, and debugpy | Use the same environment for all tools |
| Fix competing save actions | Formatting conflicts | Editor/CLI/repeated output agrees |
| Configure team environments | Tasks and remote work | Reproduce work in another environment |
| Validate proficiency | Bug-fix exercise | Turn a failure into a reviewable change |
Apply formatters and linters directly
Start with EditorConfig to create the shared lab. Install tools directly, keep small project-owned configuration files, and connect their commands to the editor.
| Files | Tutorial | Distinction to learn |
|---|---|---|
| JS/TS | Oxfmt and Oxlint | Format, lint, and types |
| YAML | Oxfmt, yamllint, and schemas | Layout, notation, application contract |
| Shell | shfmt and ShellCheck | Indentation, quoting, runtime output |
| Go | gofmt | Listed differences versus exit status |
| Python | Ruff | Format, check, imports |
| Integration | CLI, Tasks, and CI | Configuration, versions, scope, cwd |
Learn with official sources and videos
The reference library connects official sources and YouTube videos to exercises. Use Fireship's productivity walkthrough, freeCodeCamp's introductory course, and language sessions from VS Code, Microsoft Developer, and SpringDeveloper. Verify current settings against the tool author's documentation.
Read architecture and tool selection to understand language services, debuggers, and remote execution boundaries.
Maintenance and verification
Tutorial, How-to, Reference, and Explanation pages are maintained independently by topic. Each page records its source and verification date. Examples state prerequisites and limitations; merge relevant keys into the learning project's .vscode files.
Align executables, configuration, file scope, and working directory before comparing results. Record CLI checks separately from actual editor saves, breakpoints, and remote interaction.
Shortcuts and extension setup
Use essential shortcuts for OS-specific navigation, editing, and debugging. Choose an installation scope in language extensions and combined Profiles.