Konfiguracja i niezbędne rozszerzenia

Pierwsze uruchomienie

Po instalacji warto poświęcić 15 minut na konfigurację, która zwróci się godzinami. W Visual Studio Installer dla pracy nad ZEUS zaznacz workloady:

ASP.NET and web development — backend i API.
.NET desktop development — narzędzia pomocnicze.
Data storage and processing — wsparcie dla SQL/EF Core.

W VS Code instalację rozszerzeń da się zautomatyzować przez plik .vscode/extensions.json w repozytorium — wtedy każdy nowy członek zespołu dostaje propozycję instalacji tego samego zestawu.

{
  "recommendations": [
    "dbaeumer.vscode-eslint",
    "esbenp.prettier-vscode",
    "bradlc.vscode-tailwindcss",
    "ms-azuretools.vscode-docker",
    "github.vscode-pull-request-github"
  ]
}

Rozszerzenia — standard ProfessNet

Rozszerzenie	Po co
ESLint	Lintowanie kodu frontendu ZEUS
Prettier	Spójne formatowanie przy zapisie
Tailwind CSS IntelliSense	Podpowiedzi klas w Next.js
GitLens	Historia i blame inline
Docker	Edycja i podgląd kontenerów
GitHub Pull Requests	Przegląd PR bez wychodzenia z edytora

Dla Visual Studio polecamy ReSharper lub wbudowane narzędzia oraz EditorConfig (już wspierany natywnie) dla spójnego stylu.

Format przy zapisie

Zsynchronizuj formatowanie w całym zespole — koniec z diffami pełnymi zmian białych znaków. W VS Code w .vscode/settings.json:

{
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": "explicit"
  }
}

EditorConfig — jedno źródło prawdy

Plik .editorconfig w korzeniu repo działa zarówno w Visual Studio, jak i VS Code. Trzymaj go w gitcie, żeby reguły obowiązywały wszystkich.

root = true

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

[*.cs]
indent_size = 4

Wskazówka: Ustawienia w pliku .vscode/settings.json (per-projekt) mają pierwszeństwo nad Twoimi globalnymi. Dzięki temu repozytorium narzuca styl, a nie polegamy na konfiguracji każdej osoby.

Motyw i czytelność

Włącz font z ligaturami (np. Fira Code, JetBrains Mono) i podświetlanie bieżącej linii. To drobiazgi, ale przy 8 godzinach dziennie robią różnicę.

Podsumowanie

Konfigurację trzymaj w repozytorium: .editorconfig, .vscode/settings.json i extensions.json. Wtedy każdy klon repo ZEUS jest gotowy do pracy w kilka minut, a styl kodu jest jednolity bez ręcznego ustawiania.

Konfiguracja i niezbędne rozszerzenia#

Pierwsze uruchomienie#

Rozszerzenia — standard ProfessNet#

Format przy zapisie#

EditorConfig — jedno źródło prawdy#

Motyw i czytelność#