Przejdź do głównej zawartości

Konfiguracja edytora

Dostosuj swój edytor kodu aby poprawić doświadczenie programowania z Astro i odblokować nowe funkcje.

VS Code to popularny edytor kodu dla twórców stron internetowych, stworzony przez Microsoft. Silnik VS Code zasila również popularne przeglądarkowe edytory kodu, takie jak GitHub Codespaces.

Astro działa z dowolnym edytorem kodu. VS Code jest jednak przez nas zalecany jeżeli chodzi o projekty Astro. Utrzymujemy oficjalne rozszerzenie Astro dla VS Code, które pozwala na korzystanie z kilku kluczowych funkcji i usprawnień dla deweloperów w projektach Astro.

  • Podświetlanie składni w plikach .astro.
  • Informacje o typach TypeScript w plikach .astro.
  • VS Code Intellisense do uzupełniania kodu, podpowiedzi i wiele więcej.

Aby zacząć już dziś, zainstaluj rozszerzenie Astro dla VS Code.

Zobacz jak skonfigurować TypeScript (EN) w swoim projekcie Astro.

Zed to wydajny, wieloosobowy edytor kodu, zoptymalizowany pod kątem szybkości i dużych projektów. Rozszerzenie Astro dodaje między innymi podświetlanie składni plików .astro, uzupełnianie kodu, formatowanie, diagnostykę i przechodzenie do definicji.

Webstorm to IDE dla JavaScriptu i TypeScriptu, które w wersji 2024.2 dodało obsługę serwera języka Astro. Ta aktualizacja wprowadza między innymi podświetlanie składni, uzupełnianie kodu i formatowanie.

Zainstaluj oficjalną wtyczkę z JetBrains Marketplace albo wyszukaj „Astro” w zakładce Plugins w IDE. Serwer języka możesz włączać i wyłączać w Settings | Languages & Frameworks | TypeScript | Astro.

Więcej o wsparciu Astro w WebStormie znajdziesz w oficjalnej dokumentacji Astro dla WebStorma.

Nasza niesamowita społeczność utrzymuje kilka rozszerzeń do innych popularnych edytorów, w tym:

Poza lokalnymi edytorami, Astro działa również dobrze w edytorach przeglądarkowych, w tym:

  • StackBlitz i CodeSandbox - edytory online działające w przeglądarce, z wbudowanym podświetlaniem składni dla plików .astro. Nie wymagają instalacji ani konfiguracji!
  • GitHub.dev - pozwala zainstalować rozszerzenie Astro dla VS Code jako rozszerzenie webowe, co daje dostęp wyłącznie do niektórych funkcji pełnego rozszerzenia. Obecnie obsługiwane jest tylko podświetlanie składni.

ESLint jest popularnym linterem dla JavaScript i JSX. Dla obsługi Astro można zainstalować utrzymywany przez społeczność plugin.

Zobacz wskazówki dla użytkowników zawarte w projekcie, aby uzyskać więcej informacji na temat instalacji i konfiguracji ESLinta dla twojego projektu.

Stylelint jest popularnym linterem dla CSS. Utrzymywana przez społeczność konfiguracja Stylelint zapewnia obsługę Astro.

Instrukcje instalacji, integrację z edytorem oraz dodatkowe informacje znajdziesz w README projektu.

Biome to linter i formater w jednym, przeznaczony dla webu. Biome ma obecnie eksperymentalne wsparcie dla plików .astro i może lintować oraz formatować frontmatter w tych plikach.

Prettier to popularny formater dla JavaScript, HTML, CSS i wielu innych języków. Jeśli korzystasz z rozszerzenia Astro dla VS Code, formatowanie kodu Prettierem jest już w nim zawarte.

Aby dodać formatowanie plików .astro poza edytorem (na przykład w CLI) albo w edytorach, które nie obsługują naszych narzędzi, zainstaluj oficjalny plugin Prettier dla Astro.

  1. Zainstaluj prettier i prettier-plugin-astro.

    Okno terminala
    npm install --save-dev --save-exact prettier prettier-plugin-astro
  2. Utwórz plik konfiguracyjny .prettierrc (albo .prettierrc.json, .prettierrc.mjs lub inny obsługiwany format) w katalogu głównym projektu i dodaj do niego prettier-plugin-astro.

    W tym pliku wskaż też ręcznie parser dla plików Astro.

    .prettierrc
    {
    "plugins": ["prettier-plugin-astro"],
    "overrides": [
    {
    "files": "*.astro",
    "options": {
    "parser": "astro"
    }
    }
    ]
    }
  3. Opcjonalnie zainstaluj inne pluginy Prettier dla projektu i dodaj je do pliku konfiguracyjnego. Te dodatkowe pluginy mogą wymagać określonej kolejności. Na przykład przy Tailwindzie prettier-plugin-tailwindcss musi być ostatnim pluginem Prettier w tablicy plugins.

    .prettierrc
    {
    "plugins": [
    "prettier-plugin-astro",
    "prettier-plugin-tailwindcss" // musi być ostatni
    ],
    "overrides": [
    {
    "files": "*.astro",
    "options": {
    "parser": "astro"
    }
    }
    ]
    }
  4. Uruchom w terminalu poniższe polecenie, aby sformatować pliki.

    Okno terminala
    npx prettier . --write

Zobacz README plugina Prettier, aby dowiedzieć się więcej o obsługiwanych opcjach, konfiguracji Prettiera w VS Code i nie tylko.

dprint to bardzo konfigurowalny formater kodu, który obsługuje wiele języków, w tym JavaScript, TypeScript, CSS i inne. Obsługę plików .astro można dodać za pomocą pluginu markup_fmt.

Pomóż nam Społeczność Zostań sponsorem
⌂ 换网址