To access the GUI settings click the gear icon in the lower-left corner of the VS Code window. If you’re a keyboard shortcut fan then use the shortcut Ctrl + , (Windows/Linux) or Cmd + , (Mac).

This guide uses the settings.json method but each item can be found in the GUI by searching the key we provide. For example, to find rulers in the GUI you can search `editor.rulers`.

Themes

In this section we look at themes and how to adjust the visual styling of VS Code. Choosing a visual theme for VS Code may seem like it’s merely about making your editor look pretty. In truth, it is an important decision that significantly impacts the overall development experience and productivity. Here are several reasons why selecting a suitable visual theme is crucial:

1. Reduced Eye Strain: A well-designed visual theme with appropriate color choices, contrast, and syntax highlighting can reduce eye strain during long coding sessions.
2. Improved Code Readability: Visual themes play a critical role in enhancing code readability. Themes that offer clear differentiation between various code elements such as keywords, functions, variables, and comments make it easier to comprehend code at a glance.
3. Personalization and Motivation: Visual themes allow developers to create an environment that resonates with their personality and preferences. A visually appealing and personalized coding space can boost motivation and inspire creativity, making coding sessions more engaging and enjoyable.
4. Accessibility and Inclusivity: Choosing an accessible theme that considers color contrast and readability is essential for ensuring inclusivity. A theme that accommodates diverse needs, including those of developers with visual impairments or color blindness, fosters an inclusive coding environment.

Browsing themes in VS Code can be frustrating at times because there isn’t a gallery that you can quickly scan. Instead, you have to find each theme and open it in the extension marketplace. We found VS Code Themes which provides a beautiful way to quickly browse through the various color themes you can choose from.

We like One Dark Pro. However it can’t be stated enough how important it is for you to find a theme that fits what YOUR needs.

Once you choose a theme you can select it, then choose the VS Code button. This opens the theme extension in the extension marketplace.

From the marketplace page select install. Once installed, the theme is automatically enabled.

Some themes offer multiple options. Here you can see One Dark Pro has 4 different color themes to choose from.

You can also set this in settings.json .

Add the workbench.colorTheme key and VS Code will display a list of themes to choose from. If you want to choose a different theme that you have installed you can do so from the command palette.

Open the command palette and type “color theme”. Choose the Preferences: Color Theme option. Of course, you can also do this in settings.json .

We have a few small tweaks we recommend to make your editor a bit more digestible. Feel free to use any that you find useful. 

Rulers

Rulers act as subtle guides that prevent code from sprawling too far, encouraging conciseness and readability. Embracing the power of rulers in your VS Code environment empowers you to write clean, well-organized code that not only meets industry standards but also becomes a joy to work with for both you and your fellow developers. So, let your code gracefully dance along the rulers, and witness how this seemingly small addition can make a significant impact on the overall elegance and professionalism of your projects.

Adding a ruler to VS Code is a straightforward process. Open your settings.json and add the following line:

Here, we used 88 as this aligns with the Black formatter we will discuss later in this article. If your linter or formatter prefers a different line length then use that value. If you would like multiple rulers you can do that too:

The result is a vertical line at the chosen line length.

Linting

A linter is an essential tool that plays a vital role in improving the overall quality and maintainability of your code. It helps you adhere to the Python coding standards and best practices by analyzing your code for potential errors, style inconsistencies, and syntax issues. By highlighting these problems in real-time as you write your code, a linter assists you in identifying and rectifying mistakes early in the development process, reducing the chances of introducing bugs and enhancing the readability of your codebase. Using a linter not only fosters cleaner and more standardized coding practices within your team but also contributes to more efficient collaboration, making it an indispensable tool for any Django developer working with Python in the VS Code environment.

The number of options for linters is ever-growing. Here are a few of the most popular:

• Flake8
• PyLint
• Ruff

We are partial to Ruff. It is up to 100x faster than other linters, supports the latest version of Python, and has almost identical rules as Flake8. Of course, if you have a preference toward another linter use it. Much of the configuration will be similar.

Setting up Ruff couldn’t be easier. Simply install the Ruff extension from the marketplace here . It starts working immediately. Regardless of the linter you choose add the following to your Python scope in settings.json.

These two options will enable linting when you save a file. Through our testing we found a few config options specific to Ruff that make us even more productive. Let’s take a look at these.

Import auto-sorting

The PEP8 style guide details how imports should be organized. This helps keep your code both readable and maintainable. Auto-sorting will structure your Python imports first by their source (e.g. standard library, third-party, local application) then alphabetically within those sections.

Enable it by adding the editor.codeActionsOnSave section to your Python scope in settings.json.

Here you can see an example of import sorting before:

and after:

Auto-fixing Violations

Finding violations in your code is only good if you fix them. You must take action on each one. Ruff offers a way to automatically fix violations. Enable it by adding the source.fixAll key to the editor.codeActionsOnSave section of your Python scope.

Here you can see an example of auto-fixing violations. Ruff identifies that the Post class is imported but not being used.

Ruff fixes this by removing the Post import.

Formatting

A code formatter is a tool that analyzes and automatically restructures source code according to predefined coding styles and conventions. It aims to achieve consistency in code layout, indentation, line breaks, and other formatting aspects without altering the code’s functionality. By enforcing consistent code styles across a project, formatters enhance code readability, make it easier to understand, and minimize potential bugs caused by inconsistent formatting.

Much like linters there are many formatters to choose from. Here are a few of the most popular:

• Black
• YAPF
• autopep8

We prefer the style choices made by Black. Black’s approach follows the principle of “the uncompromising code formatter,” and it gains widespread recognition for its ability to produce consistent code that is highly readable.

As an example, Black uses an 88 character line length. This is in contrast to other formatters that use 80 characters. The decision to use a 10% longer limit makes a huge difference in file length. It also allows for less line wrapping which produces more readable code. Small but impactful choices like this make Black an easy choice for our development. As always, choose the formatter that aligns with your needs.

The Black extension can be found here. Install it as you would any other extension. Once installed, open settings.json and add these two options to your python scope.

These lines set the default formatter to Black and enable format on save. This means that Black will format your code only when you save a file.

Git

VS Code integrations remarkably well with version control systems like git. Simply having git installed is enough for the editor to do it’s magic. If you need to install git checkout this guide provided by git themselves. Once setup you will have a source control button your primary side bar.

Conclusion

You now have a fully configured VS Code with a gorgeous color theme, linting, formatting, and installed a few helpful extensions to make your coding hours more productive and enjoyable! By leveraging the power of Visual Studio Code and its versatile configurations, developers can unlock their full potential and take their Python development to new heights. As the development landscape continues to evolve, the adaptability and feature-rich nature of VS Code will undoubtedly keep it at the forefront of modern coding environments, empowering developers to write clean, efficient, and robust Python applications with ease.

If you liked this content and want to see more like it follow us on Twitter @OrdinaryInds.