4
0
0

Meta 把内部用了 8 年的设计系统开源了:astryx 实测,三行 CSS 跑起 174 个组件

2026-11-12
2026-11-12
文章摘要
|

一、昨天 GitHub trending 的头条,是 Meta 的「家底」

刷 GitHub trending 的时候看到一个久违的景象:榜首不是某个 AI agent 框架,而是一个前端设计系统——meta/astryx,单日揽下 2842 颗 star。截至我写这篇文章时,仓库已经 24,800+ star、1,900+ fork,而它今年 1 月才建仓,6 月 18 日才发第一篇官宣博客,9 月被 InfoQ 报道时还不到 2 万 star——这个增速在设计系统这个品类里相当罕见。

来历也确实硬:README 自述这套系统在 Meta 内部打磨了 8 年,支撑着内部 13,000 多个应用(注意这是官方自述口径,暂时没有第三方验证)。现在以 MIT 协议开源,基于 React 19+ 和 StyleX 构建,TypeScript 写的。我的第一反应是「又是大厂开源大型玩具」,但实际装上跑了一圈之后,想法变了——它的几个设计决策,确实在回应 2026 年前端开发者的真实痛点。

二、先看它是什么:174 个组件、7 套主题、一个 CLI

astryx 不是一个组件库那么简单,它是一整套体系:

  • 组件层:@astryxdesign/core,CLI 实测列出 174 个组件,从 Button、Card 这类基础件到 AlertDialog、AppShell、BaseTypeahead 这种复杂件都有,全部带无障碍标注;
  • 主题层:7 套官方主题——neutral、butter、chocolate、matcha、stone、gothic、y2k,都带暗色模式。主题的本质只是一组 CSS 自定义属性覆盖,设计师不改组件代码就能换品牌;
  • 工具层:@astryxdesign/cli,文档查询、模板脚手架、组件源码弹出、agent 集成,全靠它。

安装就是标准的三包:

一套设计系统的组件总览页面,展示 Button、Breadcrumb 等组件卡片

npm install @astryxdesign/core @astryxdesign/theme-neutral @stylexjs/stylex
npm install -D @astryxdesign/cli   # CLI 可选但强烈建议

当前版本 0.7.14(我安装时就是最新,npm 上显示 11 月 11 日刚更新过——这项目迭代很勤)。要用图表的话注意:charts/vega 相关包目前只发在 @canary tag 下,得 npm install @astryxdesign/charts@canary 才装得到。

三、五分钟上手:三行 CSS,一个 Provider

我用 npm create vite 建了个最普通的 React 19 空项目,装完包之后总共改了两个文件就跑起来了。src/main.jsx 长这样:

import { StrictMode } from 'react'
import { createRoot } from 'react-dom/client'

// 三段 CSS:reset -> 组件样式 -> 主题(顺序敏感)
import '@astryxdesign/core/reset.css'
import '@astryxdesign/core/astryx.css'
import '@astryxdesign/theme-neutral/theme.css'

import { Theme } from '@astryxdesign/core/theme'
import { Button, Card, Stack, Heading, Text } from '@astryxdesign/core'
import { neutralTheme } from '@astryxdesign/theme-neutral/built'

function App() {
  return (
    <Theme theme={neutralTheme}>
      <Stack padding={6} align="start">
        <Card maxWidth={480} elevation="low">
          <Stack gap={3} align="start">
            <Heading level={1}>Hello Astryx</Heading>
            <Text>Meta 开源设计系统实测。</Text>
            <Button variant="primary" label="点我"
                    clickAction={() => console.log('clicked')} />
          </Stack>
        </Card>
      </Stack>
    </Theme>
  )
}

createRoot(document.getElementById('root')).render(
  <StrictMode><App /></StrictMode>
)

三个 CSS import 的顺序不能乱:reset.css、astryx.css、theme.css 分别落在 @layer 的 reset、astryx-base、astryx-theme 三层里,浏览器按层叠顺序解析——这也是它能和别的样式体系和平共处的根基。组件全部从包顶层导出,Button 用 label 而不是 children 传文案(无障碍标注直接绑在 label 上),变体用 variant="primary"。

关键验证来了:npx vite build 一次通过,产物 510 KB(gzip 后 160 KB)——全程没有配置任何 Vite 插件、没有 Babel、没有 PostCSS 设置。这是 astryx 和多数 StyleX 方案最大的不同:它把样式预编译好随包分发,StyleX 只是它的内部实现细节,消费端完全无感。

四、不锁死你:Tailwind 无缝混用

设计系统最让人戒备的就是「一旦用了就被绑死」。astryx 在这点的处理很务实:

  • 每个组件都接受原生 className 和一个 xstyle prop,你的 Tailwind、CSS Modules、普通 CSS 都能直接往上盖;
  • 专门提供 @astryxdesign/core/tailwind-theme.css 这座桥,把设计 token 映射成 Tailwind 工具类。

加了这个 import 之后,对比就很直观:

// 没有桥——手写 CSS 变量,又长又容易拼错:
<div className="rounded-[var(--radius-container)]
                bg-[var(--color-background-surface)]
                text-[var(--color-text-primary)]">

// 有桥——token 直接变成工具类:
<div className="rounded-lg bg-surface text-primary">

唯一的坑在层叠顺序:如果项目里已有 Tailwind,@layer 声明行必须写在 Tailwind 的 import 上面。官方文档特别警告:顺序写反,级联会静默反转,样式全乱但没有报错——排查起来非常痛苦。

五、组件不合身?swizzle 把源码整个弹给你

这是我最喜欢的设计。多数设计系统遇到「这个组件差一点不能改」的场景,你只能在组件外面包 wrapper 或者提 issue 干等。astryx 的做法是一条命令:

npx @astryxdesign/cli swizzle Button
# [ok] Copied 24 files to components/astryx/Button/

实测一次弹出 24 个文件:Button 的完整源码,加上它依赖的 21 个内部模块(类型定义、i18n 回退文案、按压态样式、触控热区逻辑……)全部拷进你项目的 components/astryx/ 目录,从此这个组件归你,想怎么改怎么改。目录里还会留一个 astryx-swizzle.json 标记文件,配合 @astryxdesign/build 的 Babel/PostCSS/Vite 集成,主题覆盖依然能作用到你的副本上。

一个注意点:swizzle 副本要吃到主题覆盖,需要接入 @astryxdesign/build 的构建集成(Vite/Babel/PostCSS/webpack 都有,withAstryx() 即可),而且目前 Turbopack 还不认这个标记——用 Turbopack 的项目先别动 swizzle。

六、为 AI agent 而造,不是说说而已

astryx 的 README 有一句定位:「fully customizable and built for how we build now: by people and the agents working alongside them」。听起来像宣传语,但 CLI 里有实打实的东西。装完 CLI 跑一条命令:

npx @astryxdesign/cli init
# [ok] AI agent docs installed -> AGENTS.md, GEMINI.md

它会往你项目里写两份文件(实测两种都生成了),AGENTS.md 的内容大概是这个画风:

Astryx v0.7.14 · 174 components
SETUP —— 没有这三行组件会裸奔:import reset.css、import astryx.css、挂主题
WORKFLOW —— 每个页面从模板起步,别从零手搓:先 astryx build "<想法>" 选模板,再 astryx template <name> <path> 落地,缺块用 astryx template <Block> 补,用组件前先 astryx component <Name> 读 props。
交付前跑 astryx doctor --built <dir>,不过关就别交付。

也就是说,你的 AI 编程助手打开项目就能读到:装了什么版本、174 个组件怎么查、页面该按什么流程搭、交付前怎么自检。而 astryx component Button 吐出来的是完整的结构说明、最佳实践(「primary 变体一个视图只放一个」「destructive 操作必须配确认步骤」)、无障碍对比度要求、全量 props 表——这密度对人类是文档,对 agent 是可直接消费的上下文。「agent ready」翻译过来就是:它假设你的协作对象里有一半不是人。

七、上生产之前,几个冷静点

热榜归热榜,真要引入自己的项目,这些现状得先看清:

  • 还在 Beta:仓库至今没有一个 tagged release,版本号 0.7.x,API 可能还会动;
  • 部分包没跟上:charts/vega 只在 canary,lab 系列压根没发 npm;
  • issue 不少:目前 679 个未关闭的 issue 和 PR(GitHub API 数据,含 PR),Beta 期正常,但要有心理预期;
  • 命令别敲错:非 scope 的 astryx 命令在 npm 上是另一个无关包,必须用 npx @astryxdesign/cli,这是官方文档专门警告过的;
  • 环境要求看准:React 19+ 是硬要求(peerDependency),但 README 里写的 Node 22+/pnpm 11 那是给贡献者的,消费端没有这个门槛。

八、总结

一天下来,astryx 给我的印象是「工程决策非常诚实」:不逼你换样式体系(预编译 CSS + className 逃生门)、不锁你进组件黑盒(swizzle 直接给源码)、不假装 AI 不存在(CLI 原生面向 agent)。如果它保持这个迭代质量,等 1.0 那天,React 生态「组件库怎么选」这个老问题可能真要多一个重量级答案。想尝鲜的,Vite 建个项目装三包,五分钟就能摸到全部核心能力——反正不要服务器,也不要改构建配置。

仓库在这:github.com/meta/astryx,文档站 astryx.atmeta.com。

以上内容为 GLM 5.3 Agent 整合定时发布。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!

Meta 把内部用了 8 年的设计系统开源了:astryx 实测,三行 CSS 跑起 174 个组件
/archives/tech-blog-2026-11-12
作者
番茄酱唉
发布于
2026-11-12
许可协议
CC BY-NC-SA 4.0

评论

欢迎来到我的博客!