Dashdashforce

Pragmatic Programmer Code Navigation Challenges in VS Code

Cover Image for Pragmatic Programmer Code Navigation Challenges in VS Code

Years ago I read Pragmatic Programmer by Andy Hunt and David Thomas. Because I was pretty new in my career, a lot of it didn't sink in well or have a ton of meaning to me although it was still a very valuable read. Like watching that movie when you're 9 years old that in adulthood takes on a whole new meaning. Well I've been re-reading it and thoroughly enjoying my second go through.

One section throws a gauntlet of sorts that I'm finally taking seriously. In "Topic 18: Power Editing" the authors present the idea of being fluent in your editor of choice and give the following challenges to be able to do without touching the mouse:

  • When editing text, move and make selections by character, word, line, and paragraph.
  • When editing code, move by various syntactic units (matching delimiters, functions, modules, …).
  • Re-indent code following changes.
  • Comment and uncomment blocks of code with a single command. Undo and redo changes.
  • Split the editor window into multiple panels, and navigate between them.
  • Navigate to a particular line number.
  • Sort selected lines.
  • Search for both strings and regular expressions, and repeat previous searches.
  • Display compilation errors in the current project.
  • Run the current project’s tests.

Upon reading this section again I was happy to be able to do about 70% of these in VS Code. My mom was actually a medical transcriptionist for a time and as a result when she taught me to use a computer she was already far more fluent than most in text editing shortcuts than most due to the value of speed when dictating doctors and the fact she started that job before mice were common. What a blessed upraising for a future software engineer as most of those shortcuts still work in modern text editors.

In this post I'm going to walk through the Pragmatic Programmer fluency challenges and how to do them along with as many different solutions to those tasks as I can find, as a few of them have multiple solutions depending on your keyboard, OS, and project. I will specify when commands differ between operating systems or frequently with Windows/Mac I'll just say

CTRL/CMD + ...

To represent the Windows / Mac control and command keys respectively as they are most commonly just swapped with the rest of the command staying the same.

Fluency Challenge Solutions

When editing text, move and make selections by character, word, line, and paragraph

To move by a single character use the Arrow keys. To select by one character use Shift + Right/Left Arrow. Bonus, use Shift + Down Arrow to highlight the rest of a line to the right down to the next line (with the cursor in the middle somewhere), and Shift + Up Arrow to highlight the rest of the line to the left.

To move by one word on Windows use Ctrl + Right/Left Arrow. On Mac it's a little different with OPT + Right/Left Arrow. To highlight by one word use Shift + Ctrl + Right/Left Arrow with Mac being the same command but swap Ctrl for OPT.

A optional trick that helps with the next one is moving to the start and end of a line which can be done a few ways. To move to the beginning of the line you can use the HOME key if you have one, or on Mac you can use CMD + Right/Left Arrow. END key for jumping to the end if you have one.

To select a whole line theres a few ways you can do it with different results. If you are at the start or end of the line and do Shift + HOME/END and the whole line (as displayed in your VS Code UI but not necessarily the whole line if its long and has a line break in the UI) will be highlighted. On Mac you can also use CMD + Shift + Right/Left Arrow to get the same effect. VS Code on Windows also has the command CTRL + L which will select the whole line even if it is broken into multiple visual lines via the VS Code UI. Here's two screenshots that shot the different results.

Via Shift + HOME/END Shift End

and via CTRL + L Ctrl L

That last one fulfills the "select by paragraph" challenge too.

When editing code, move by various syntactic units (matching delimiters, functions, modules, …)

This was one I didn't know how to do before starting this challenge and I'm very glad I did. There's a few solutions to these.

To jump delimiters: To go from one end of a parenthesis or bracket pair you can use: CTRL + Shift + </kbd> on Windows, and on Mac you can use CMD + Shift + </kbd>. I for one had no idea this existed and feel very dumb for not using it all these years especially in massive functions or nested data structures.

To jump functions/methods: When you're in a file that has many functions, methods etc you can use what VS Code calls "go to symbol" via CTRL + Shift + O on Windows, and on Mac its CMD + Shift + O. This creates a drop down like this

Go to symbol

which you can then navigate either via arrows or typing a search. It even works in Markdown documents but lets you jump between headers. This one I knew about being in the UI via clicking the current method name in the bar above the file, but the shortcut is wonderful.

Re-indent code following changes

Two solutions here. If you have some sort of auto formatting tool like Auto Pep8 or ESLINT configured and the indent you desire follows a formatting standard you can run CTRL + K (this invokes a special two part command unique to VS Code and Visual Studio) followed by CTRL + F and the whole document will be auto formatted. On Mac its CMD + K followed by CMD + F. This is a rather nuclear solution though and not specific to the line question.

To indent just one line use CTRL + ] or CTRL + [ on Windows, or Mac use CMD + ] or CMD + [ to indent / out-dent the line your cursor is on.

Comment and uncomment blocks of code with a single command. Undo and redo changes

Two solutions to this one in VS Code. The simplest on Windows is CTRL + / or on Mac CMD + / which comments the current line. You can also use CTRL/CMD + K followed by CTRL/CMD + C.

Split the editor window into multiple panels, and navigate between them.

To split the editor into two panels on Windows you can use CTRL + </kbd> and on Mac its CMD + </kbd>. This opens your current file into another split panel.

There are two different sets of shortcuts for navigating the tabs and groups of tabs created by this. One Windows, to navigate to the first editor group use CTRL + 1 and use ALT + 1 for going to a specific tab within that group. You can sub out 1 for any other number depending where you want to go.

Same features on Mac but it's CMD + 1 for editor groups and CTRL + 1 for individual tabs. That one hurts the brain a bit to switch between.

Navigate to a particular line number

On Windows hit CTRL + G and then type your desired line number. On Mac it's the same story but with CMD + G instead.

Sort selected lines

This one blew my mind a bit. Select some lines and then open the command palette with CTRL/CMD + Shift + P, and search "sort". Turns out VS Code can sort ascending or descending just like that.

Search for both strings and regular expressions, and repeat previous searches

VS Code supports regex and text searching in it's two different search locations. One via CTRL/CMD + F which will search your current file. The shortcut to get into regex mode gives me issues though on Windows as it collides with Nvidia software.ALT + R opens up an Nvidia overlay for my GPU. Can't say I use regex search enough to fix that on my Windows machine. Heck I'll probably use this overlay for GPU usage more...

Using CTRL/CMD + Shift + F will open up the left side panel for searching your entire project. From here you can also search both text and regex, along with open up other inputs for including/excluding file types and directories.

Display compilation errors in the current project

This one lives in the integrated terminal which you can open with CTRL/CMD + ` and then click over into the "Problems" tab, or even faster you can use CTRL/CMD + Shift + M to jump straight into the "Problems" tab.

Run the current project’s tests

For this you might have a few different solutions depending on how your project is setup and what tools you're using. One project I work in we use VS Code's "Tasks" concept to control building and testing the application, so I used the command palette to open "Tasks" and then select the one I want.

A very frequently used command however for compiling a project is CTRL/CMD + Shift + B but as I said it depends on your project, how it's configured, and what extensions you have running. If I run that command right now I get both the Golang and Rust extensions trying to build my project even though my blog is currently a Ruby project. Not really what I want. You might get similar weirdness with command "Run Tests" shortcuts as it might run tests in one language but not another. Consult with your project and it's extensions to find the shortcut for running tests and use VS Code's "Tasks" concept if you can't find something default that works.

Lesson learned: The most import keyboard shortcut in VS Code is

CTRL/CMD + Shift + P

When in doubt, open the command palette and search for it.

Happy typing. Hope you have a good keyboard.