Gatsby 框架中安装

安装和配置 Gatsby。

更新： 我们在 canary 发布版本中已完全支持 React 19 和 Tailwind v4。有关更多信息，请参见 Tailwind v4 文档。

创建项目

首先，使用 create-gatsby 创建一个新的 Gatsby 项目：

npm init gatsby

配置 Gatsby 项目以使用 TypeScript 和 Tailwind CSS

系统会询问几个问题来配置您的项目：

✔ 你希望你的站点叫什么名字？
· your-app-name
✔ 你希望为你的站点创建一个什么名称的文件夹？
· your-app-name
✔ 你会使用 JavaScript 还是 TypeScript？
· TypeScript
✔ 你会使用 CMS 吗？
· 选择你想要的
✔ 你想安装一个样式系统吗？
· Tailwind CSS
✔ 你想使用其他插件安装额外的功能吗？
· 选择你想要的
✔ 我们可以开始吗？ (Y/n) · Yes

编辑 tsconfig.json 文件

向 tsconfig.json 文件中添加以下代码以解析路径：

{
  "compilerOptions": {
    // ...
    "baseUrl": ".",
    "paths": {
      "@/*": [
        "./src/*"
      ]
    }
    // ...
  }
}

创建 gatsby-node.ts 文件

如果项目根目录下尚未存在 gatsby-node.ts 文件，请创建该文件，并将以下代码添加到 gatsby-node 文件中，以便您的应用能够解析路径：

import * as path from "path"
export const onCreateWebpackConfig = ({ actions }) => {
  actions.setWebpackConfig({
    resolve: {
      alias: {
        "@/components": path.resolve(__dirname, "src/components"),
        "@/lib/utils": path.resolve(__dirname, "src/lib/utils"),
      },
    },
  })
}

运行 CLI

运行 shadcn-ui 初始化命令来设置您的项目：

pnpmnpmyarnbun

pnpm dlx shadcn@latest init

配置 components.json

系统会询问几个问题来配置 components.json：

你想使用 TypeScript 吗（推荐）？ no / yes
你想使用哪种样式？ › Default
你希望使用什么颜色作为基础颜色？ › Slate
你的全局 CSS 文件在哪里？ › › ./src/styles/globals.css
你想使用 CSS 变量来设置颜色吗？ › no / yes
你的 tailwind.config.js 文件在哪里？ › tailwind.config.js
配置组件的导入别名： › @/components
配置 utils 的导入别名： › @/lib/utils
你使用 React 服务器组件吗？ › no

就这样

现在，您可以开始向项目中添加组件。

pnpmnpmyarnbun

pnpm dlx shadcn@latest add button

上述命令将会把 Button 组件添加到您的项目中。然后，您可以像这样导入它：

import { Button } from "@/components/ui/button"
export default function Home() {
  return (
    <div>
      <Button>Click me</Button>
    </div>
  )
}