744

For every typescript file visual studio code uses an auto indentation of 8 spaces. This is a bit too much for my taste but I can't find where to change it.

Maybe it's available as a setting but under a different name as I can't find anything related to indentation.

UPDATE

I'm currently using the Prettier code formatter and that solves all formatting problems by auto formatting on save (if there is no syntax error)

HMR
  • 37,593
  • 24
  • 91
  • 160
  • **See Also**: [How can I customize the tab-to-space conversion factor?](https://stackoverflow.com/q/29972396/1366033) – KyleMit Jan 18 '21 at 20:14

21 Answers21

1016

In the toolbar in the bottom right corner you will see a item that looks like the following: enter image description here After clicking on it you will get the option to indent using either spaces or tabs. After selecting your indent type you will then have the option to change how big an indent is. In the case of the example above, indentation is set to 4 space characters per indent. If tab is selected as your indentation character then you will see Tab Size instead of Spaces

If you want to have this apply to all files and not on an individual file basis, then override the Editor: Tab Size and Editor: Insert Spaces settings in either User Settings or Workspace Settings depending on your needs

Edit 1

To get to your user or workspace settings go to Preferences -> Settings. Verify that you are on the User or Workspace tab depending on your needs and use the search bar to locate the settings. You may also want to disable Editor: Detect Indentation as this setting will override what you set for Editor: Insert Spaces and Editor: Tab Size when it is enabled

Caustic
  • 475
  • 3
  • 14
elliot-j
  • 10,709
  • 3
  • 19
  • 18
  • @yildizm85 the image is working without issue for me. The image was a direct upload to SO so if its broken it may be an issue on their end. – elliot-j Dec 20 '17 at 05:48
  • 67
    Changing `editor.tabSpaces` does _not_ change the spacing in all files. It only changes it for future-created files. There's still no solution for fixing all files in one action. – Jacob Stamm Apr 28 '18 at 23:51
  • 1
    Not responsive to the question which is how to change the indent size. – Dogweather Apr 24 '19 at 22:36
  • @JacobStamm, if you set editor.detectIndentation to false - at least you don't need to click every time you open old file to change it to different (valid) value as described below by Rmuesi – Nigrimmist Jun 27 '19 at 13:24
  • 8
    This is super unintuitive. I already have indentation set to use spaces. Why do I need to click on the spaces option to get to a second, hidden menu to set the number of spaces? Every other editor I've used is one click on the indentation details in the status bar and there's a number of spaces option. In VS Code I need to look this up on Stack Overflow because the menu I want is hidden behind an option I'm not trying to change. – ian.pvd Jun 27 '19 at 20:49
  • 2
    it always seems to revert back to the default of 4 space every time i create a new file?!?! – oldboy Sep 28 '19 at 04:56
  • @BugWhisperer changing the spacing as shown in the screenshot in the answer only affects the current file. Did you try updating your User or workspaces settings as suggested? – elliot-j Oct 02 '19 at 15:53
  • @JacobStamm you can also use the "Convert Indentation to Spaces" and "Convert Indentation to Tabs" commands to apply the change to the file that you are currently editing. – elliot-j Oct 02 '19 at 16:34
  • Looks like v1.40 has fix the bug that count'd effect all files, `"editor.detectIndentation": false, "editor.insertSpaces": false, "editor.tabSize": 4,` – KaKa Dec 17 '19 at 00:48
  • this doesn't set the global configuration, just the current file – Pablo Pazos May 18 '20 at 00:17
  • @elliot-j Does not work for me. Opening a file with tabs of size=2, selecting all text, pressing F1 and selecting the `Convert Indentation to Spaces`, pressing F1 again and selecting `Convert Indentation to Tabs` still keeps tabs size=2 (when on the settings is set to 4). – Nicke Manarin Jul 08 '20 at 18:42
  • A picture is worth a thousand words. – Daniel Viglione Dec 17 '22 at 21:51
524

You can change this in global User level (all your projects if not deliberately set) or Workspace level (only for the current working project).

Open the settings: Click the gear on the bottom left, then click Settings as shown below.

Settings on VS Code menu

Then, do the following 2 changes: (type tabSize in the search bar)

  1. Uncheck the checkbox of Detect Indentation
  2. Change the tab size to be 2/4 (Although I strongly think 2 is correct for JS. Haha :))

vscode set tabsize

Xin
  • 33,823
  • 14
  • 84
  • 85
  • 5
    For those wondering, this will automatically reformat all files in your project, not just new ones you create. You might have to restart vs code for changes to take effect. – Andrew Einhorn Aug 28 '21 at 07:55
  • Both of these settings were already good to go on my installation (box checked, spaces set as I like it; and this is on a brand new angular project, so no copy/pasted code to screw things up), but it still didn't take, at least for the typescript files. I added a language specific setting as described by Martin Schneider above, so hopefully that'll work. – PaulBunion Sep 16 '21 at 14:13
  • Update on my previous comment: It seems angular generated a '.editorconfig' file as well that I hadn't noticed before. In that file, the property 'indent_size' was set to 2 when I wanted 4. That was probably the original culprit. I've set that to 4 and removed the language-specific setting. – PaulBunion Sep 16 '21 at 14:48
355

To change the indentation based on programming language:

  1. Open the Command Palette (CtrlShiftP | macOS: P).
  2. Type and select: Preferences: Configure Language Specific Settings... (command id: workbench.action.configureLanguageBasedSettings).
  3. Select a programming language (for example TypeScript).
  • If Settings menu is opened (since 1.66.0):
    4. Press to place the cursor right beside the language filter (e.g. @lang:typescript).
    5. Type Tab Size and enter your preferred value in the text box.

  • If settings.json file is opened:
    4. Add this code:

    "[typescript]": {
        "editor.tabSize": 2
    }
    

See also: VS Code Docs

Martin Schneider
  • 14,263
  • 7
  • 55
  • 58
  • 1
    How (where) does one use the command id? I don't see "Configure Language Specific Settings" under File-Preferences. – Alan Baljeu Apr 27 '19 at 14:49
  • 1
    @AlanBaljeu You can use command ids e.g. to define keyboard shortcuts. There is no "Configure Language Specific Settings" under File > Preferences, because step 2 is not a menu entry, but the text in italics should be entered into the input field that appears after performing step 1. – Martin Schneider Sep 20 '21 at 12:58
  • how do you change based on file extension? – Vic Jan 24 '22 at 17:49
  • @Vic see [Language identifier](https://code.visualstudio.com/docs/languages/overview#_language-identifier) and "Adding a file extension to a language" below. – Martin Schneider Jan 25 '22 at 09:16
  • "Add this code"... to where? These instructions didn't open a text file. – Grant Birchmeier Apr 08 '22 at 18:33
  • @GrantBirchmeier the latest VS Code update 12 days ago has changed the behavior. I have updated my answer. – Martin Schneider Apr 11 '22 at 11:10
66

Code Formatting Shortcut:

VSCode on Windows - Shift + Alt + F

VSCode on MacOS - Shift + Option + F

VSCode on Ubuntu - Ctrl + Shift + I

You can also customize this shortcut using preference setting if needed.

column selection with keyboard Ctrl + Shift + Alt + Arrow

Sujatha Girijala
  • 1,141
  • 8
  • 20
63

You might also want to set the editor.detectIndentation to false, in addition to Elliot-J's answer.

VSCode will overwrite your editor.tabSize and editor.insertSpaces settings per file if it detects that a file has a different tab or spaces indentation pattern. You can run into this issue if you add existing files to your project, or if you add files using code generators like Angular Cli. The above setting prevents VSCode from doing this.

RMuesi
  • 2,852
  • 1
  • 24
  • 27
37

In my case "EditorConfig for VS Code" extention is overriding VSCode settings. If you have it installed, then check .editorconfig file in the root folder of the project.

Here is an example config. The "indent_size" sets the number of spaces for a tab.

# editorconfig.org
root = true

[*]
indent_style = space
indent_size = 4
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true

[*.md]
trim_trailing_whitespace = false
Grazerbeam
  • 345
  • 4
  • 17
Aviw
  • 1,056
  • 11
  • 14
22

How to turn 4 spaces indents in all files in VS Code to 2 spaces

  • Open file search
  • Turn on Regular Expressions
  • Enter: ( {2})(?: {2})(\b|(?!=[,'";\.:\*\\\/\{\}\[\]\(\)])) in the search field
  • Enter: $1 in the replace field

How to turn 2 spaces indents in all files in VS Code to 4 spaces

  • Open file search
  • Turn on Regular Expressions
  • Enter: ( {2})(\b|(?!=[,'";\.:\\*\\\/{\}\[\]\(\)])) in the search field
  • Enter: $1$1 in the replace field

NOTE: You must turn on PERL Regex first. This is How:

  • Open settings and go to the JSON file
  • add the following to the JSON file "search.usePCRE2": true

Hope someone sees this.

casual234
  • 661
  • 6
  • 7
  • 3
    Specifically for VS Code, there is also [an extension](https://marketplace.visualstudio.com/items?itemName=Compulim.indent4to2) for converting 4 to 2 spaces. – tanius May 17 '20 at 21:08
15

Simplified explanation with pictures for those that googled "Change indentation in VS Code"

Step 1: Click on Preferences > Settings

enter image description here

Step 2: The setting you are looking for is "Detect Indentation", begin typing that. Click on "Editor: Tab Size"

enter image description here

Step 3: Scroll down to "Editor: Tab Size" and type in 2 (or whatever you need).

enter image description here



Changes are automatically saved

enter image description here

Example of my changes

enter image description here

Community
  • 1
  • 1
JGallardo
  • 11,074
  • 10
  • 82
  • 96
13

To set all existing files and new files to space identation to 2 just put it in your settingns.json (in the root of json):

"[typescript]": {
        "editor.defaultFormatter": "vscode.typescript-language-features",
        "editor.tabSize": 2,
        "editor.insertSpaces": true,
        "editor.detectIndentation":false
 }

you can add the language type of the configuration:

"[javascript]": {
    "editor.tabSize": 2,
    "editor.insertSpaces": true,
    "editor.detectIndentation":false
} 
Reculos Gerbi Neto
  • 399
  • 1
  • 6
  • 17
  • 1
    These days I use prettier.js and the js plugin as it takes care about spacing and other re aligning long lines as well as most anything else. – HMR Aug 30 '19 at 17:30
8

Setting the indentation in preferences isn't allways the solution. Most of the time the indentation is right except you happen to copy some code code from other sources or your collegue make something for you and has different settings. Then you want to just quickly convert the indentation from 2 to 4 or the other way round.

That's what this vscode extension is doing for you

enter image description here

Hexodus
  • 12,361
  • 6
  • 53
  • 72
7

Step 1: Open settings.json in vscode

Step 2: Add the lines as below for the programming language (an example is below)

For typescript and javascript

"editor.detectIndentation": false,
"[typescript]": {
        "editor.defaultFormatter": "vscode.typescript-language-features",
        "editor.tabSize": 2,
        "editor.insertSpaces": true,
        "editor.detectIndentation":false
 },
"[javascript]": {
    "editor.tabSize": 2,
    "editor.insertSpaces": true,
    "editor.detectIndentation":false
}
Pierre
  • 2,552
  • 5
  • 26
  • 47
Anand Raja
  • 2,676
  • 1
  • 30
  • 35
  • `Open settings.json in vscode` The way to do that is ctrl+shit+p and type settings or cmd+shift+p on Mac. There is a global settings.json and a workspace settings.json. I prefer using prettier.js as my formatter because it has more style settings. – HMR Jun 22 '21 at 12:34
5

Problem: The accepted answer does not actually fix the indentation in the current document.

Solution: Run Format Document to re-process the document according to current (new) settings.

Problem: The HTML docs in my projects are of type "Django HTML" not "HTML" and there is no formatter available.

Solution: Switch them to syntax "HTML", format them, then switch back to "Django HTML."

Problem: The HTML formatter doesn't know how to handle Django template tags and undoes much of my carefully applied nesting.

Solution: Install the Indent 4-2 extension, which performs indentation strictly, without regard to the current language syntax (which is what I want in this case).

shacker
  • 14,712
  • 8
  • 89
  • 89
4

I wanted to change the indentation of my existing HTML file from 4 spaces to 2 spaces.

I clicked the 'Spaces: 4' button in the status bar and changed them to two in the next dialog box.

I use 'vim' extension. I don't how to re-indent without vim

To re-indent my current file, I used this:

gg

=

G
Rounak
  • 613
  • 3
  • 8
  • 22
2

Check tabWidth if you are using a formatter, that was the issue in my case. It represents the number of spaces used in tabs.

enter image description here

Nacho
  • 210
  • 3
  • 10
1

Adding on: yes, you can use the bottom-right UI to configure the space settings. But if you have existing code that's not formatted to the new spacing, then you can right-click anywhere within the file and click Format Document. Took me a while to figure this out until I stumbled on this issue.

Format Document menu

Wompinalong
  • 143
  • 1
  • 8
  • 1
    Ok I installed Ruby, Ruby Formatter, and Rufo as described. Changed from 2 to 4 spaces. Then right-click and Format. Nothing changed for me. – jersey bean Nov 03 '20 at 16:50
  • 1
    I have "Spaces: 4" in my toolbar, I have a JSON file where most of it is formatted to 4-characters. But when I right click and select "Format Document", it *all* gets reindented to 2-characters. I have "detectIndentation" set to false. I don't get it.... – Mike Gledhill Aug 31 '22 at 07:59
1

For me it was docs-markdown andDocs Authoring Pack. Microsoft's many modules messing with each other yet again! Disabled the extensions and now good to go again

Carlos Soriano
  • 669
  • 6
  • 6
0

The Problem of auto deintending is caused due to a checkbox being active in the settings of VSCode. Follow these steps:

  1. goto preferences

  2. goto settings

  3. search 'editor:trim auto whitespace' EDITOR Picture

  4. Uncheck The box

0

The following search-and-replace regex changes the number of spaces per indentation level from 4 to 2 in existing files. It's relatively easy to understand, reliable, and doesn't require installing anything.

Instructions

  • Press CtrlH (or ⌥⌘F on macOS).
  • Make sure regex matching is on by clicking on the .* button in the search popup or pressing AltR (or ⌥⌘R on macOS).
  • In the Find field, enter ^(?:( ) )?(?:( ) )?(?:( ) )?(?:( ) )?(?:( ) )?(?:( ) )?(?:( ) )?(?:( ) )?(?:( ) )?
  • In the Replace field, enter $1$2$3$4$5$6$7$8$9
  • Finally press CtrlEnter (or ⌘Enter on macOS) to apply to the current file.

You could also use this in the Search pane on the left to do this across all files in your project. However, note that this should only be run once per file. It will mess up the indentation of files that already use 2 spaces.

 


Extra Credit: How It Works

The way the regular expression works is it matches groups (?: ... ) of four spaces at a time at the beginning ^ ... of each line, only capturing ( ... ) the first two spaces. Each indentation level is optional ... ?, so it works for as many indentation levels as the pattern is repeated and there are in each line. Then it replaces the whole pattern with only the captured spaces $1, $2, ..., effectively replacing every four-space indentation level with two spaces.

This pattern only works up to 9 indentation levels (I'm not sure if $10 would work, but if so this could be expanded indefinitely).

Extra Extra Credit: Extending

You could adapt the pattern to decrease the number of spaces per indentation level in a file from any original number to another lower target number.

Put the target number of spaces inside the inner parenthesis. Then, put the remaining original number of spaces in the outer parenthesis, so the total number of spaces in the pattern is the original.

For example, if you want to change the indentation level from 6 to 4, repeat this search pattern as many times as you like:

^(?:( ) )? or ^(?:( {4}) {2})?

And use the same number of $1, $2 in the replacement pattern.

Andres Riofrio
  • 9,851
  • 7
  • 40
  • 60
0

First, check if you have installed "EditorConfig for VS Code". It was overriding my editor settings. I spent all day correcting this problem.

In the project find .editorconfig file and ones changed there it will work.

0

I like these settings for indentation you can modify them according to need.

You can open VScode setting.json file by typing CTRL+SHIFT+P and paste below the JSON setting

setting.json

"[javascript]": {
    "editor.defaultFormatter": "vscode.typescript-language-features",
    "editor.formatOnSave": true,
    "editor.tabSize": 4,
    "editor.insertSpaces": false,
    "editor.detectIndentation": false,
    "editor.wrappingIndent": "deepIndent", 
    "editor.autoIndent": "full"
},
"[typescript]": {
    "editor.defaultFormatter": "vscode.typescript-language-features",
    "editor.formatOnSave": true,
    "editor.tabSize": 4,
    "editor.insertSpaces": false,
    "editor.detectIndentation": false,
    "editor.wrappingIndent": "deepIndent", 
    "editor.autoIndent": "full"
}
M. Hamza Rajput
  • 7,810
  • 2
  • 41
  • 36
0

With VSCode 1.75 (Jan. 2023), indentation is also customizable on VSCode terminals, not just VSCode views.

See issues 170432: "Add a terminal tab stop size (editor.tabSize) setting"

When a tab is printed in the terminal, it has a tab size of 8 spaces, regardless of the tab size setting.

Therefore, PR 170733 adds a new setting:

terminal.integrated.tabStopWidth: The number of cells in a tab stop

VonC
  • 1,262,500
  • 529
  • 4,410
  • 5,250