# はじめに

> Astro か Vite のプロジェクトに gosfc を追加し、Vue コンポーネントや .astro ファイルに最初の Go を書きます。

Go 1.27 以降と Node.js が必要です。アプリは Node.js のプロジェクトであると同時に
Go のモジュールでもあります (ルートに `go.mod`)。コンポーネントが import する Go の
パッケージはその中に置きます。

## インストールと Astro の設定

1. Go モジュールに goesm と gosfc をツールとして追加します。バージョンは go.mod / go.sum で固定されます。gosfc には goesm v0.0.1-beta.3 以降が必要です。

   ```sh
   go get -tool github.com/goesm-dev/goesm/cmd/goesm@<version>
   go get -tool github.com/goesm-dev/gosfc/cmd/gosfc@<version>
   ```

2. Astro にインテグレーションを追加します。プロジェクトに `@astrojs/vue` がインストールされていれば、設定に無い場合に追加されます。Go を `.astro` ファイルだけに書くプロジェクトには、Vue も `@astrojs/vue` も要りません。[examples/astro-go](https://github.com/goesm-dev/gosfc/tree/v0.0.1-beta.7/examples/astro-go) がその例です。

   ```js
   // astro.config.mjs
   import { defineConfig } from "astro/config";
   import gosfc from "@gosfc/astro";

   export default defineConfig({
     integrations: [gosfc()],
   });
   ```

3. `.vue` で `<script setup lang="go">` を使います。

   ```astro
   ---
   import Summary from "../features/cart/Summary.vue";
   ---

   <Summary />
   ```

   `.astro` ファイルも Go で書けます。書き方は「[.astro ファイルで Go を使う](https://goesm.dev/gosfc/ja/guide/astro.md)」で説明します。

Vite だけで使う場合は `@vitejs/plugin-vue` の前に `@gosfc/vite` を置きます。

```js
import vue from "@vitejs/plugin-vue";
import gosfc from "@gosfc/vite";

export default { plugins: [gosfc(), vue()] };
```

`lang="ts"` や素の `<script setup>` のコンポーネントはそのまま共存できます。gosfc が触るのは `lang="go"` のコンポーネントだけです。

## 次に読むもの

- [Go ブロックの書き方](https://goesm.dev/gosfc/ja/guide/go-block.md): ブロックに書けるものと、テンプレートからの見え方
- [.astro ファイルで Go を使う](https://goesm.dev/gosfc/ja/guide/astro.md): `.astro` ファイルのフロントマターと
  `<script>` に書く Go
- [JavaScript から Go を import する](https://goesm.dev/gosfc/ja/guide/importing-go.md): `.astro`、`.ts`、`.js`
  ファイルでの `go:` の import
