Definování konzistentních stylů kódování pomocí EditorConfig

Pokud chcete vynutit konzistentní styly kódování pro všechny, kteří pracují v základu kódu, můžete do svého řešení nebo projektu přidat .editorConfig soubor. Nastavení souborů EditorConfig dodržuje specifikaci formátu souboru, kterou udržuje EditorConfig.org. Mnoho editorů kódu a aplikací podporuje soubory EditorConfig, včetně sady Visual Studio. Vzhledem k tomu, že nastavení jsou v souboru, doprovází váš kód a dá se použít i mimo Visual Studio.

V sadě Visual Studio má nastavení souboru EditorConfig přednost před různými globálními nastaveními textového editoru, která jsou k dispozici v části Nástroje>Možnosti>textového editoru>C/C++>Code Style. Pomocí souboru EditorConfig můžete přizpůsobit každý základ kódu tak, aby používal nastavení textového editoru specifické pro daný projekt.

Soubor EditorConfig můžete ručně naplnit nebo ho automaticky vygenerovat na základě nastavení stylu kódu, které jste vybrali v sadě Visual Studio. Pokud chcete vytvořit nový .editorconfig soubor na základě aktuálního nastavení sady Visual Studio, v hlavní nabídce sady Visual Studio zvolte Nástroje>Možnosti>textového editoru>C/C++>Obecné. Pak v nastavení zvolte Vygenerovat soubor .editorconfig. Zvolte složku, ve které je projekt, a pak zvolte Vybrat složku , do které chcete soubor uložit .editorconfig .

Pokud používáte soubor EditorConfig, můžete v textovém editoru sady Visual Studio dál nastavit vlastní předvolby editoru. Tato nastavení textového editoru platí vždy, když pracujete v základu kódu bez souboru EditorConfig nebo když soubor EditorConfig nepřepíše konkrétní nastavení. Příkladem takové předvolby je použití tabulátorů nebo mezer pro styl odsazení kódu.

Když do projektu v sadě Visual Studio přidáte soubor EditorConfig, budou na základě nastavení EditorConfig formátovány pouze nové řádky kódu. Formátování existujícího kódu se nezmění, pokud nespustíte jeden z následujících příkazů:

• Vyčištění kódu

  V editoru sady Visual Studio vyberte vyčištění kódu nebo stiskněte ctrl+K, Ctrl+E. Tento příkaz se vztahuje na nastavení prázdných znaků, například styl odsazení a vybraná nastavení stylu kódu, jako jsou předvolby závorek.

• Formátovat dokument

  Vyberte Upravit dokument> rozšířeného>formátu nebo stiskněte Ctrl+K, Ctrl+D ve výchozím profilu. Tento příkaz se vztahuje pouze na nastavení prázdných znaků, jako je například styl odsazení.

Poznámka:

Tento článek se týká sady Visual Studio pro Windows. Informace o Visual Studio pro Mac naleznete v tématu Vytváření a úpravy vlastního souboru EditorConfig v Visual Studio pro Mac.

Konzistence kódu

Nastavení souborů EditorConfig umožňuje udržovat konzistentní styly a konvence kódování v základu kódu bez ohledu na editor nebo integrované vývojové prostředí, které používáte. Některé styly kódování, které můžete řídit, jsou styl odsazení, šířka tabulátoru, znaky konce řádku a kódování. Pokud má například základ kódu jazyka C# konvenci, která odsadí pět znaků mezer, dokumenty používají kódování UTF-8 a řádky končí cr/LF, můžete nakonfigurovat soubor EditorConfig tak, aby používal tuto konvenci.

Soubory EditorConfig jsou užitečné, když se konvence kódování, které používáte ve svých osobních projektech, liší od těchto konvencí používaných v projektech vašeho týmu. Můžete například chtít, aby odsazení přidalo do kódu znak tabulátoru. Váš tým ale může raději přidat čtyři mezery. Soubory EditorConfig tento problém vyřeší tím, že vám umožní mít konfiguraci pro každý scénář.

Vzhledem k tomu, že .editorconfig soubor v základu kódu obsahuje nastavení EditorConfig, cestují spolu s tímto základem kódu. Pokud otevřete soubor kódu v editoru kompatibilním s editorem EditorConfig, aktivují se nastavení textového editoru.

Podporovaná nastavení

Editor v sadě Visual Studio podporuje základní sadu vlastností EditorConfig:

• indent_style
• indent_size
• tab_width
• end_of_line
• znaková sada
• trim_trailing_whitespace
• insert_final_newline
• kořen

EditorConfig podporuje všechny jazyky podporované sadou Visual Studio s výjimkou nastavení editoru EditorConfig podpory XML.

EditorConfig podporuje konvence stylu kódu, včetně jazyka, formátování a konvencí pojmenování pro C# a Visual Basic.

Přidání a odebrání souborů EditorConfig

Když do projektu nebo základu kódu přidáte soubor EditorConfig, Visual Studio naformátuje všechny nové řádky kódu, které napíšete, podle nastavení souboru EditorConfig. Visual Studio ale nepřevádí existující styly na nové, dokud dokument nenaformátujete nebo nespustíte vyčištění kódu. Pokud jsou například odsazení v souboru formátované pomocí karet a přidáte soubor EditorConfig, který formátuje odsazení mezerami, znaky odsazení se automaticky nepřevedou na mezery. Když dokument naformátujete (vyberte Upravit>dokument rozšířeného>formátu nebo stisknete Ctrl+K, Ctrl+D), použije se u existujících řádků kódu nastavení prázdných znaků v souboru EditorConfig.

Pokud odeberete soubor EditorConfig z projektu nebo základu kódu, musíte zavřít a znovu otevřít všechny otevřené soubory kódu pro globální nastavení editoru, aby se projevily nové řádky kódu.

Přidání souboru EditorConfig do projektu

Pokud chcete do projektu nebo řešení přidat soubor EditorConfig, postupujte takto:

1. Otevřete projekt nebo řešení v sadě Visual Studio. Vyberte buď řešení, nebo uzel projektu v závislosti na tom, jestli se má nastavení EditorConfig použít pro všechny projekty v řešení, nebo jenom pro jeden. Můžete také vybrat složku v projektu nebo řešení, do které chcete soubor přidat .editorconfig .

2. V nabídce zvolte Možnost Přidat novou položku projektu>nebo stiskněte kombinaci kláves Ctrl+Shift+A.

   Otevře se dialogové okno Přidat novou položku .

3. Do vyhledávacího pole zadejte editorconfig.

   Ve výsledcích hledání se zobrazují dvě šablony položek souboru editorconfig.

   

4. Vyberte šablonu editorconfig File (empty) a přidejte předem vyplněný soubor EditorConfig s výchozími možnostmi EditorConfig pro prázdné znaky, styl kódu a zásady vytváření názvů. Nebo vyberte šablonu souboru editorconfig (.NET) a přidejte předem vyplněný soubor EditorConfig s výchozími prázdnými znaky .NET, stylem kódu a zásadami vytváření názvů.

   V Průzkumník řešení se zobrazí nový .editorconfig soubor a otevře se v editoru jako nová karta.

   

5. Volitelně upravte soubor a pak ho uložte.

Další způsoby přidání souboru EditorConfig

Existuje několik dalších způsobů, jak do projektu přidat soubor EditorConfig:

• K vygenerování .editorconfig souboru v řešení použijte IntelliCode pro Visual Studio. Klikněte pravým tlačítkem na Průzkumník řešení a v místní nabídce zvolte Přidat>nový editorConfig (IntelliCode). IntelliCode pro Visual Studio odvodí styly kódu z existujícího kódu a pak vytvoří soubor EditorConfig s předdefinovanými předvolbami stylu kódu.

• Automaticky vygenerujte soubor EditorConfig na základě nastavení stylu kódu.

Hierarchie souborů a priorita

Když přidáte .editorconfig soubor do složky v hierarchii souborů, jeho nastavení platí pro všechny příslušné soubory na této úrovni a nižší. Můžete také přepsat nastavení EditorConfig pro konkrétní projekt, základ kódu nebo část základu kódu, aby používal jiné konvence než jiné části základu kódu. To může být užitečné při začlenění kódu odjinud a nechcete měnit jeho konvence.

Postupujte podle těchto pokynů:

• Pokud chcete přepsat některá nebo všechna nastavení EditorConfig, přidejte .editorconfig soubor na úrovni hierarchie souborů, kterou chcete použít. Nové nastavení souboru EditorConfig platí pro soubory na stejné úrovni a soubory v libovolném podadresáři.

  

• Pokud chcete některá nastavení přepsat, ale ne všechna nastavení, zadejte pouze tato nastavení v .editorconfig souboru. Přepíše se pouze ty vlastnosti, které explicitně vypíšete v souboru nižší úrovně .editorconfig . Další nastavení ze všech souborů vyšší úrovně .editorconfig se budou dál používat.

• Pokud chcete zajistit, aby v této části základu kódu nebyla použita žádná nastavení z žádného souboru vyšší úrovně .editorconfig , přidejte root=true vlastnost do souboru nižší úrovně .editorconfig .

  # top-most EditorConfig file for this level
  root = true
  

Soubory EditorConfig se čtou shora dolů. Pokud existuje více vlastností se stejným názvem, má přednost vlastnost naposledy nalezená se stejným názvem.

Úprava souborů EditorConfig

Visual Studio 2022 poskytuje vizuální editor pro soubory EditorConfig.

Po úpravě souboru EditorConfig je nutné znovu načíst soubory kódu, aby se nové nastavení projevilo.

Příklad

Následující příklad ukazuje stav odsazení fragmentu kódu jazyka C# před a po přidání souboru EditorConfig do projektu:

1. V dialogovém okně Možnosti nástrojů>nastavte nastavení Editoru textu>C#>Tabs pro textový editor sady Visual Studio tak, aby se při stisknutí klávesy Tab vytvořily čtyři znaky mezery.

   

2. Podle očekávání se při stisknutí klávesy Tab na dalším řádku odsadí řádek přidáním čtyř prázdných znaků.

   

3. Pomocí EditorConfig přepněte nastavení karet tak, aby používaly karty.

   V souboru EditorConfig vyberte Použít tabulátory .

   

4. Když stisknete klávesu Tab , zobrazí se místo mezer znaky tabulátoru.

   

Řešení potíží s nastavením EditorConfig

Pokud soubor EditorConfig existuje kdekoli v adresářové struktuře v umístění projektu nebo nad jeho umístěním, sada Visual Studio použije nastavení editoru v daném souboru do vašeho editoru. V tomto případě se na stavovém řádku může zobrazit následující zpráva:

User preferences for this file type are overridden by this project's coding conventions.

To znamená, že pokud jsou některá nastavení editoru v Editoru možností>>editoru (například velikost odsazení a styl, velikost tabulátoru nebo konvence kódování) zadána v souboru EditorConfig v adresářové struktuře nebo nad projektem v adresářové struktuře, přepíší konvence v souboru EditorConfig nastavení v textovém editoru.

Při řešení potíží s EditorConfig postupujte takto:

1. Pokud chcete podporu EditorConfig pro Visual Studio vypnout, zrušte zaškrtnutí políčka Sledovat konvence kódování projektu v textovém editoru Možností>nástrojů.>

   

2. Pokud chcete najít všechny soubory EditorConfig v nadřazených adresářích projektu, otevřete příkazový řádek a spusťte následující příkaz z kořenového adresáře disku, který obsahuje váš projekt.

   dir .editorconfig /s
   

3. Pokud chcete řídit rozsah konvencí EditorConfig, nastavte root=true vlastnost v .editorconfig souboru v kořenovém adresáři úložiště nebo v adresáři, ve kterém se projekt nachází.

   Visual Studio hledá soubor pojmenovaný .editorconfig v adresáři otevřeného souboru a v každém nadřazeném adresáři. Hledání skončí, když dosáhne kořenové cesty k souboru nebo pokud .editorconfig je nalezen soubor s root=true .

Související obsah

• Možnosti pravidla stylu kódu pro .NET
• Podpora EditorConfig pro vaši jazykovou službu
• EditorConfig.org
• Funkce editoru kódu
• Vytvoření a úprava vlastního souboru EditorConfig v Visual Studio pro Mac
• Konfigurační soubory pro pravidla analýzy kódu