FDE Times 数据在招 FDE 职位 873▼9 近 7 天在招职位数的变化(同口径比较):不计入本周新开始追踪的公司的职位近 7 天新增 55在招公司 181支持远程 25%美国薪资中位数 $200k招聘最多 Databricks 98
ENVI

前线部署工程师(FDE)的专业媒体

工具

FDE 应自己掌握界面代码,而不是装一个 UI 库

shadcn/ui 把组件代码直接复制进仓库,管理后台想怎么改就怎么改,不必等任何人。

分享微博

要点速览

  • shadcn/ui 不是装上就用的库:CLI 把组件代码复制进你的仓库,你直接在仓库里修改
  • Sidebar 现成可用,Data Table 则要按指南在 TanStack Table 上自己组装
  • 代码归你,补丁也归你:没有自动更新,重新运行生成命令会覆盖文件
示意图:shadcn CLI 把组件代码复制进你的仓库。components/ui 层(button、sidebar、table)以橙色标出,可直接修改;它导入 node_modules 中的 Radix 包,这些包仍是普通依赖。一个红色警示框提示:重新运行 CLI 会覆盖你的修改。
shadcn/ui 把组件代码复制进你的仓库,最上层可以直接修改。下面的 Radix 包仍在 node_modules 中,重新运行生成命令会覆盖你的改动。来源:shadcn/ui 文档、Vercel Academy、PkgPulse。

设想这样一个场景:周一和客户见面,周五就要演示一个处理订单的智能体。智能体能跑通,但客户的操作人员需要一个界面来审核它的输出,而项目里没有设计师。

这时最合适的工具,是能让你在自己仓库里改动界面每一行代码的工具。一个好看但封闭的 UI 库,想改点什么都得绕路,偏偏会在你最需要提速的那一周拖慢你。

shadcn/ui 走的就是这条路。它的 GitHub 仓库称其为可组合、注重无障碍的组件。官方文档说得更直接:它不是一个组件库,而是一种构建你自己组件库的方式。

对前线部署工程师(FDE)来说,这个区别不只是措辞问题。每次演示都会遇到客户想改个小细节的时刻。修改自己掌握的文件,远比想办法改动别人维护的包要快。

组件代码就在你的仓库里

项目把这条原则称为 Open Code。文档说得很干脆:最上层的组件代码由你直接修改,想改按钮,就打开按钮的代码去改。客户希望状态列给逾期订单显示红色徽标时,你不用覆盖别人的样式,也不用等 issue 的回复。

Vercel Academy 总结得很到位:传统组件库建立的是依赖关系,shadcn/ui 建立的是所有权关系。样式基于 Tailwind CSS。Tailwind CSS 4.0 于 2025 年 1 月 22 日发布,最大的变化是把项目配置从 JavaScript 移到了 CSS。

订单审核演示:一步步来

回到订单审核界面。假设你从一个使用 React 和 TypeScript 的 Vite 项目起步。在 Vite 上使用 Tailwind v4 需要两样东西:@tailwindcss/vite 插件,以及 CSS 文件里的一行 import。之后,shadcn CLI 的 add 命令会把组件及其依赖加进项目。

npm install tailwindcss @tailwindcss/vite
npm install -D @types/node   # 让 vite.config 可以使用 path 模块
# 在 src/index.css 中,把全部内容替换为:@import "tailwindcss";

光装包还不够,插件必须在 vite.config.ts 里注册。顺便声明一个指向 src 目录的 @ 别名,因为组件代码都以 @/components/ui/button 这样的形式导入:

// vite.config.ts
import path from "path"
import react from "@vitejs/plugin-react"
import tailwindcss from "@tailwindcss/vite"
import { defineConfig } from "vite"

export default defineConfig({
  plugins: [react(), tailwindcss()],
  resolve: { alias: { "@": path.resolve(__dirname, "./src") } },
})

TypeScript 也得认识这个别名。在 tsconfig.json 中(如果模板拆分了文件,tsconfig.app.json 也要改),给 compilerOptions 加两行:"baseUrl": "." 和 "paths": { "@/*": ["./src/*"] }。漏了这一步,init 很难顺利运行,@/... 导入也会报错,赶工时很容易卡在这里。

npx shadcn@latest init
npx shadcn@latest add sidebar table button
npm install @tanstack/react-table

由于 Tailwind v4 在 CSS 里配置,换成客户品牌色要改的是 CSS 文件,而不是 JavaScript 文件。能快速换色很值。客户管理层在界面上看到自家品牌色时,更容易把这个工具看作公司自己的东西,而不是外人做的原型。

add sidebar 则会给你一个导航栏,文档称它可组合、可换主题、可定制:左边菜单,右边内容,就是所有管理后台熟悉的框架。

最费功夫的是订单表格。shadcn/ui 的 Data Table 不是预先打包好的表格。文档没有提供现成组件,而是给出一份指南,教你在 TanStack Table 上自己组装表格。

这种组装方式其实很适合在客户现场工作。假设智能体处理了 200 个订单。操作人员只需要按“待审核”状态筛选,按创建日期排序以先看最早的订单,再点击某一行查看智能体的决定。

你只定义这几列,只加一个排序和一个筛选,别的都不要。下面的示例很精简,但导入语句齐全;用 Table 组件渲染表格的部分,按指南自己补上:

// columns.tsx
import { ColumnDef } from "@tanstack/react-table"
import { Button } from "@/components/ui/button"

export type Order = { id: string; status: "needs_review" | "approved"; createdAt: string }

export const columns: ColumnDef<Order>[] = [
  { accessorKey: "id", header: "订单 ID" },
  { accessorKey: "status", header: "状态" },
  {
    accessorKey: "createdAt",
    header: ({ column }) => (
      <Button variant="ghost"
        onClick={() => column.toggleSorting(column.getIsSorted() === "asc")}>
        创建时间
      </Button>
    ),
  },
]
// data-table.tsx(示例:省略了渲染表格的 JSX)
import { useState } from "react"
import {
  useReactTable,
  getCoreRowModel,
  getSortedRowModel,
  getFilteredRowModel,
  SortingState,
  ColumnFiltersState,
} from "@tanstack/react-table"
import { columns, Order } from "./columns"

export function OrdersTable({ data }: { data: Order[] }) {
  const [sorting, setSorting] = useState<SortingState>([])
  const [columnFilters, setColumnFilters] = useState<ColumnFiltersState>([])

  const table = useReactTable({
    data, columns,
    getCoreRowModel: getCoreRowModel(),
    getSortedRowModel: getSortedRowModel(),
    getFilteredRowModel: getFilteredRowModel(),
    onSortingChange: setSorting,
    onColumnFiltersChange: setColumnFilters,
    state: { sorting, columnFilters },
  })
  // “待审核”按钮:table.getColumn("status")?.setFilterValue("needs_review")
  // ……渲染 table.getHeaderGroups() 和 table.getRowModel().rows
}

自己掌握代码的代价

缺点就藏在优点里。Vercel Academy 把代价讲得很清楚:你失去了自动更新和自动安全补丁。据 PkgPulse 介绍,要更新某个组件,得重新运行它的生成命令,而这条命令会覆盖文件,不先做比对的话,你的修改可能就丢了。

也别以为一切都归你所有。PkgPulse 指出,复制过来的组件仍然依赖 node_modules 里的 Radix 包。你掌握的是最上层,下面那层依旧是普通依赖。

无障碍同样需要留意。这些组件在设计时考虑了无障碍,但一旦为了迎合客户改了标记,就没人替你重新检查。演示阶段可以接受;如果这个界面即将成为正式上线的内部工具,交付前要和客户商定由谁维护界面代码。

生态还在演进。2026 年 8 月的更新日志提到,GitHub registry 现已支持私有仓库,团队可以把定制过的内部组件集中放在一个私有位置。对同时运行多个项目的客户,交付时值得提一下。

最后一个局限是 Data Table。因为要自己组装,如果你刚接触 TanStack Table,这里最耗时间。签合同之前就把它学会,别拖到周四晚上。

先学什么,简历上怎么写

合理的顺序是先学 Tailwind,因为组件构建在它之上,同时学会在 Vite 里配置插件和别名。然后学 init 和 add 命令,把大部分时间花在 TanStack Table 上,这是唯一必须真正弄懂、不能只复制来用的部分。

至于职业发展,一个能用的管理后台,招聘经理可以自己点开试,比任何描述技能的句子都更有说服力。简历上别写含糊的“熟悉 React”,而是写类似“搭建了审核智能体输出的界面,支持基于真实数据的排序和筛选”,并附上仓库链接。

你不需要成为设计师。值得证明的是:客户问“能给我看看吗?”的时候,你能当场打开一个界面给他们看。

这篇文章对你有帮助吗?

10 个信源
路线图上的下一篇 · 阶段 2: 全栈工程能力FDE 用 AWS CDK 复刻客户基础设施,不必从头再敲最常见的坑是写死的存储桶名或改名的构造,任何一个都会让本该顺利重复的部署失败。