UI组件后端【免费下载链接】dicebearDiceBear is an avatar library for designers and developers. 项目地址https://gitcode.com/gh_mirrors/di/dicebear点击查看免费下载本篇指南聚焦 DiceBear 官方 Rust 实现dicebear-core与dicebear-styles两个 crate讲解如何在 Rust 1.80 的服务端环境中不经外部服务直接生成 SVG 头像。读完本文你将掌握从安装、Style/Avatar核心类型、确定性 seed 机制到全部核心选项与多头像渲染等完整实战能力并能理解其输出与 JavaScript 等其余语言实现字节级一致的底层原理。概览服务端原生、零外部依赖DiceBear 的 Rust 版本让你在 Rust 进程中本地生成头像无需调用任何外部头像服务。它继承了 DiceBear 一贯的设计API 镜像 JavaScript 库Avatar、Style、OptionsDescriptor等公共类型与 JavaScript 库集成指南中的用法一一对应输出字节级一致相同的seed 相同的风格 相同的选项在任何 DiceBear 语言实现中都会产生完全相同的 SVG。这一点由仓库内的跨语言 parity fixtures位于 tests/fixtures/parity逐一校验见 Rust core 的 crate 文档 中的说明。从源码结构看Rust 实现完整复刻了参考实现的全链路Style解析并校验风格定义 →Avatar用基于 seed 的确定性 PRNG 解析选项 → 渲染器输出 SVG。整个管线被拆分为 prng、resolver、renderer 等内部模块公共 API 只有Avatar、Style、OptionsDescriptor、color工具与Error。环境要求与安装需要Rust 1.80 或更高版本——Rust 移植版使用了std::sync::LazyLock这也在 src/rust/core/README.md 与 Cargo.toml 中注明。安装需要两个 cratedicebear-core核心库负责解析、解析与渲染dicebear-styles头像风格定义集合每个风格对应一个同名 feature如lorelei、bottts、avataaars按需开启即可serde_json因为选项以serde_json::Value形式传入需要一并添加。cargo add dicebear-core serde_json cargo add dicebear-styles --features lorelei以当前仓库为例src/rust/core/Cargo.toml 中dicebear-core的版本为11.0.0-rc.2并声明了对dicebear-schema纯数据 schema crate用于运行时校验风格定义与选项与jsonschema、serde、indexmap等依赖。其中两个 feature 值得注意serde_json启用了float_roundtrip保证浮点数字格式化后不出现 1 ULP 的偏差以免破坏 SVG 数字的字节级 parity和preserve_order保持 JSON 键序使 SVG 属性按源码顺序输出indexmap同样用于保持属性顺序。快速上手生成第一个头像以下示例使用 lorelei 风格更多风格见风格总览use dicebear_core::{Avatar, Style}; use serde_json::json; let style Style::from_str(dicebear_styles::LORELEI)?; let avatar Avatar::new(style, json!({ seed: John, // ... other options }))?; let svg avatar.to_svg();调用链非常清晰从 avatar.rs 可以看到Avatar::new的完整流程校验选项crate::validate::options见 validate.rs内部使用dicebear-schema提供的 draft-07 JSON Schema 编译出的LazyLock校验器构造Optionsoptions.rs负责把用户的标量/数组/区间输入归一化为统一形态构造Resolverresolver.rs用 seed 初始化 PRNG 并逐个解析确定性取值构造Renderer渲染 SVG把解析后的选项快照存入resolved_options。每个头像风格都有自己的一套组件与颜色选项具体参数见各风格详情页例如 lorelei。确定性头像seed 与 PRNG 原理seed选项是生成确定性头像的关键相同的 seed 永远产生相同的头像let avatar1 Avatar::new(style, json!({ seed: user-123 }))?; let avatar2 Avatar::new(style, json!({ seed: user-123 }))?; assert_eq!(avatar1.to_svg(), avatar2.to_svg());底层机制在 prng.rs这是一个基于 key 的伪随机数生成器。每个方法都接收一个 key将seed:key先经 FNV-1a 哈希fnv1a.rs 内的fnv1a::hash再作为 Mulberry32mulberry32.rs的种子生成一个[0,1)浮点数。因此PRNG 的取值与调用顺序无关同一 seed key 组合永远得到同一结果——这是跨语言、跨调用输出一致的根基。Prng提供pick去重后按 UTF-16 排序再确定性选取、weighted_pick按权重选取全零权重时回退为无权重选取、bool按 0–100 概率返回、float/integer区间内取值可带步长、shuffleFisher-Yates 洗牌等方法均通过get_value派生出确定性数值。这些原语都有对应的 parity 测试见 prng.rs 内的测试模块与仓库 tests/fixtures/parity 中的fnv1a.json、mulberry32.json、prng.json逐项比对。核心类型详解StyleStyle是一个经过校验的、不可变的风格定义包装器。你可以用Style::from_str从 JSON 字符串或Style::from_value从serde_json::Value构建一次然后复用于生成多个头像use dicebear_core::{Avatar, Style}; use serde_json::json; let style Style::from_str(definition_json)?; let avatar1 Avatar::new(style, json!({ seed: Alice }))?; let avatar2 Avatar::new(style, json!({ seed: Bob }))?;从 style.rs 可以看到构建时的完整校验序列先跑 JSON Schema 校验validate::definition再反序列化随后执行 Schema 无法表达的跨键约束校验——包括检查每个extends别名引用的组件必须存在且不能是别名禁止别名链、以及动画关键帧必须严格按at升序排列。Style内部把定义拆解为 canvas、element、component、color、meta 等子模块见 src/rust/core/src/style 目录并预计算has_animations与animation_names供选项描述器使用。AvatarAvatar是生成头像的主类型。Avatar::new接收Style与一个serde_json::Value选项对象返回ResultAvatar, Error——非法选项与循环颜色引用都会以Error形式暴露详见 error.rsError有三种变体Parse、Validation、CircularColorReference后者会携带形成闭环的颜色解析链。use dicebear_core::{Avatar, Style}; use serde_json::json; let avatar Avatar::new(style, json!({ // ... options }))?;值得注意的细节avatar.rsnull选项被当作空对象处理其他任何非对象值都会校验失败。构造即完成校验 → 解析 → 渲染之后只需通过访问方法取出不同序列化形式。OptionsDescriptorOptionsDescriptor描述某个风格接受的全部有效选项非常适合用来搭建 UI 表单或校验用户输入use dicebear_core::{OptionsDescriptor, Style}; let descriptor OptionsDescriptor::new(style).to_json();其实现见 options_descriptor.rs返回一个选项名 → 字段元数据的映射例如seedstring、sizenumber1–4096、flipenumnone/horizontal/vertical/both、scalerange0–10、borderRadiusrange0–50、rotate/translateX/translateYrange±360 / ±1000等每个组件生成${name}Variant带weighted标记的 enum与${name}Probability0–100每个颜色含隐式background生成${name}Color、${name}ColorFill、${name}ColorAngle、${name}ColorOrder等字段并保留定义中的contrastTo/notEqualTo约束。tags与动画相关选项仅在风格确实包含时才被广告出来——对静态风格传入tags/animation会被接受但不生效。方法与输出格式to_svg()/to_string()返回类型str/String以 XML 格式返回头像 SVG。Avatar同时实现了Display因此可以直接用于字符串上下文format!、println!、.to_string()let avatar Avatar::new(style, json!({ seed: Alice }))?; let svg avatar.to_svg(); // or let svg avatar.to_string();to_json()返回类型serde_json::Value包含svg与options两个键返回 SVG 与解析后的选项let avatar Avatar::new(style, json!({ seed: Alice }))?; let result avatar.to_json(); // result[svg] → svg.../svg // result[options] → { seed: Alice, ... }两个实现细节值得注意见 avatar.rs 与 resolver.rs 的注释原始 seed 会被刻意排除在解析后的选项之外防止序列化后泄露 seed而选项键的顺序、整数值序列化如size:128而不是128.0都被 tests/api.rs 中的测试锁定为与 JS 端口逐字节一致。to_data_uri()返回类型String返回头像的 data URI 形式可直接用于img标签let avatar Avatar::new(style, json!({ seed: Alice }))?; let data_uri avatar.to_data_uri(); // img src{data_uri} altAvatar /其前缀固定为data:image/svgxml;charsetutf-8,且对 SVG 内容的百分号编码完全复刻 JavaScriptencodeURIComponent的语义只保留A-Za-z0-9-_.!~*()不转义见 avatar.rs 内的encode_uri_component函数。Core options全参数参考以下选项在所有 DiceBear 实现中通用完整参考见 Core options下面是 Rust 语法中的完整形态let avatar Avatar::new(style, json!({ seed: Alice, flip: horizontal, // none, horizontal, vertical, both rotate: 10, // -360 to 360, or [min, max] range scale: 0.9, // 0 to 10 (1 original), or [min, max] range borderRadius: 50, // 0-50 (50 circle) size: 128, translateX: 0, // -1000 to 1000 (percent of canvas width) translateY: 0, // -1000 to 1000 (percent of canvas height) idRandomization: true, title: User Avatar, fontFamily: Arial, // or [Arial, Helvetica] fontWeight: 700, // 1-1000 backgroundColor: [#b6e3f4, #c0aede], backgroundColorFill: solid, // solid, linear, radial }))?;各参数的取值范围与默认值可以从 options_descriptor.rs 中一一核对选项类型取值范围说明seedstring—确定性随机数种子sizenumber1–4096输出尺寸像素flipenumnone/horizontal/vertical/both镜像翻转可传数组fontFamilystring—字体族可传数组fontWeightnumber1–1000字重可传数组scalerange0–10缩放倍数1 为原始尺寸borderRadiusrange0–50圆角50 为圆形rotaterange-360–360旋转角度translateX/translateYrange-1000–1000位移占画布宽/高的百分比idRandomizationboolean—随机化 SVG 内部 IDtitlestring—SVGtitle标题从 options.rs 可以看到一个关键归一化行为rotate、scale、borderRadius、translateX/translateY这类区间型选项接受裸数字、[n]、[min, max]三种写法——裸数字等价于min max的固定值空数组视为未设置而flip、fontFamily、fontWeight、颜色等列表型选项接受标量或数组统一归一化为列表后交给 resolver。此外tags过滤器支持category/category:value/!…否定语法详见 customize/tags 参考。动态组件与颜色选项同样以这套规则工作每个组件可以传${name}Variant带权重、${name}Probability每个颜色可以传${name}Color、${name}ColorFillsolid/linear/radial、${name}ColorAngle、${name}ColorOrderrandom/fixed。所有可用模式见 Dynamic component options。实战示例自定义背景let avatar Avatar::new(style, json!({ seed: Alice, backgroundColor: [#b6e3f4, #c0aede, #d1d4f9], }))?;固定尺寸头像使用 bottts 风格生成固定 128px、圆形裁剪的机器人头像use dicebear_core::{Avatar, Style}; use serde_json::json; let style Style::from_str(dicebear_styles::BOTTTS)?; let avatar Avatar::new(style, json!({ seed: robot-42, size: 128, borderRadius: 50, // circular avatar }))?;带变换的头像use dicebear_core::{Avatar, Style}; use serde_json::json; let style Style::from_str(dicebear_styles::AVATAAARS)?; let avatar Avatar::new(style, json!({ seed: Jane, flip: horizontal, rotate: 10, scale: 0.9, translateY: 5, }))?;同页渲染多个头像在同一页面渲染多个头像时开启idRandomization可以避免 SVG 内部 ID 冲突clipPath、渐变等 ID 若重复会导致引用串台let style Style::from_str(dicebear_styles::LORELEI)?; let avatars: VecString [alice, bob, charlie] .iter() .map(|seed| { Avatar::new(style, json!({ seed: seed, idRandomization: true })) .map(|a| a.to_svg().to_string()) }) .collect::Result_, _()?;该行为的实现细节见 tests/api.rs 中id_randomization_uses_an_ascii_word_boundary测试ID 收集使用 ASCII 词边界复刻 JavaScript\b语义随机后缀追加在每个id...之后因此多个头像间的 ID 互不干扰。加权变体选择topVariant传入一个变体名 → 权重的对象控制组件变体的选取概率let avatar Avatar::new(style, json!({ seed: Alice, topVariant: { short01: 2, short02: 2, long01: 1 }, }))?;在底层options.rs 的component_variant加权映射支持三种形态裸字符串权重 1、字符串数组每项权重 1、对象每项指定权重最终由Prng::weighted_pick按权重确定性选取若所有权重为零则回退为无权重选取保证结果仍然确定。一致性验证跨语言字节级对齐DiceBear 各语言实现共享同一套 PRNG 与渲染管线这是相同 seed 风格 选项输出逐字节相同的保证。Rust 移植版对此的验证分两层共享 fixtures仓库根目录 tests/fixtures/parity 存放了fnv1a.json、mulberry32.json、prng.json、colors.json、initials.json等基础数据以及avatars/、descriptors/、styles/目录下按风格组织的完整快照lorelei、bottts、avataaars等均在其中。Rust core 的测试直接从这些文件读取并断言输出一致见 prng.rs 的测试模块与 tests/api.rs细节锁定to_json的键序、整数值序列化、渐变 stop 顺序、ColorOrder: fixed时的颜色排列等容易被浮点精度或顺序差异破坏的点都有专门的回归测试。正因如此你可以在 Rust 服务端生成头像的同时放心地与前端 JavaScript 版见 JavaScript 集成指南混用同一套 seed两端渲染结果完全一致。许可说明DiceBear 的头像风格来自众多创作者每个创作者为自己的风格选择许可协议因此使用某个风格前请确认其授权范围。许可证总览 汇总了所有风格的许可信息一处查全。dicebear-core本身采用 MIT 许可见 src/rust/core/LICENSE。赞分享UI组件后端【免费下载链接】dicebearDiceBear is an avatar library for designers and developers. 项目地址https://gitcode.com/gh_mirrors/di/dicebear点击查看免费下载相关推荐DiceBear Go 头像库指南在 Go 服务中生成确定性 SVG 头像DiceBear Go 头像库指南在 Go 服务中生成确定性 SVG 头像 本指南围绕 DiceBear 官方 Go 语言实现 github.com/dicUI组件后端DiceBear PHP 集成指南在服务端生成确定性 SVG 头像DiceBear PHP 集成指南在服务端生成确定性 SVG 头像 DiceBear 官方为 PHP 提供了与 JavaScript 库 API 完全对齐的纯UI组件后端DiceBear 头像库入门指南多语言确定性 SVG 头像生成与集成实战DiceBear 头像库入门指南多语言确定性 SVG 头像生成与集成实战 DiceBear 是一个开源的头像Avatar生成库它把任意 seed 字符串UI组件后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 DiceBear Rust 头像库实战：在服务端原生生成确定性 SVG 头像
UI组件后端【免费下载链接】dicebearDiceBear is an avatar library for designers and developers. 项目地址https://gitcode.com/gh_mirrors/di/dicebear点击查看免费下载本篇指南聚焦 DiceBear 官方 Rust 实现dicebear-core与dicebear-styles两个 crate讲解如何在 Rust 1.80 的服务端环境中不经外部服务直接生成 SVG 头像。读完本文你将掌握从安装、Style/Avatar核心类型、确定性 seed 机制到全部核心选项与多头像渲染等完整实战能力并能理解其输出与 JavaScript 等其余语言实现字节级一致的底层原理。概览服务端原生、零外部依赖DiceBear 的 Rust 版本让你在 Rust 进程中本地生成头像无需调用任何外部头像服务。它继承了 DiceBear 一贯的设计API 镜像 JavaScript 库Avatar、Style、OptionsDescriptor等公共类型与 JavaScript 库集成指南中的用法一一对应输出字节级一致相同的seed 相同的风格 相同的选项在任何 DiceBear 语言实现中都会产生完全相同的 SVG。这一点由仓库内的跨语言 parity fixtures位于 tests/fixtures/parity逐一校验见 Rust core 的 crate 文档 中的说明。从源码结构看Rust 实现完整复刻了参考实现的全链路Style解析并校验风格定义 →Avatar用基于 seed 的确定性 PRNG 解析选项 → 渲染器输出 SVG。整个管线被拆分为 prng、resolver、renderer 等内部模块公共 API 只有Avatar、Style、OptionsDescriptor、color工具与Error。环境要求与安装需要Rust 1.80 或更高版本——Rust 移植版使用了std::sync::LazyLock这也在 src/rust/core/README.md 与 Cargo.toml 中注明。安装需要两个 cratedicebear-core核心库负责解析、解析与渲染dicebear-styles头像风格定义集合每个风格对应一个同名 feature如lorelei、bottts、avataaars按需开启即可serde_json因为选项以serde_json::Value形式传入需要一并添加。cargo add dicebear-core serde_json cargo add dicebear-styles --features lorelei以当前仓库为例src/rust/core/Cargo.toml 中dicebear-core的版本为11.0.0-rc.2并声明了对dicebear-schema纯数据 schema crate用于运行时校验风格定义与选项与jsonschema、serde、indexmap等依赖。其中两个 feature 值得注意serde_json启用了float_roundtrip保证浮点数字格式化后不出现 1 ULP 的偏差以免破坏 SVG 数字的字节级 parity和preserve_order保持 JSON 键序使 SVG 属性按源码顺序输出indexmap同样用于保持属性顺序。快速上手生成第一个头像以下示例使用 lorelei 风格更多风格见风格总览use dicebear_core::{Avatar, Style}; use serde_json::json; let style Style::from_str(dicebear_styles::LORELEI)?; let avatar Avatar::new(style, json!({ seed: John, // ... other options }))?; let svg avatar.to_svg();调用链非常清晰从 avatar.rs 可以看到Avatar::new的完整流程校验选项crate::validate::options见 validate.rs内部使用dicebear-schema提供的 draft-07 JSON Schema 编译出的LazyLock校验器构造Optionsoptions.rs负责把用户的标量/数组/区间输入归一化为统一形态构造Resolverresolver.rs用 seed 初始化 PRNG 并逐个解析确定性取值构造Renderer渲染 SVG把解析后的选项快照存入resolved_options。每个头像风格都有自己的一套组件与颜色选项具体参数见各风格详情页例如 lorelei。确定性头像seed 与 PRNG 原理seed选项是生成确定性头像的关键相同的 seed 永远产生相同的头像let avatar1 Avatar::new(style, json!({ seed: user-123 }))?; let avatar2 Avatar::new(style, json!({ seed: user-123 }))?; assert_eq!(avatar1.to_svg(), avatar2.to_svg());底层机制在 prng.rs这是一个基于 key 的伪随机数生成器。每个方法都接收一个 key将seed:key先经 FNV-1a 哈希fnv1a.rs 内的fnv1a::hash再作为 Mulberry32mulberry32.rs的种子生成一个[0,1)浮点数。因此PRNG 的取值与调用顺序无关同一 seed key 组合永远得到同一结果——这是跨语言、跨调用输出一致的根基。Prng提供pick去重后按 UTF-16 排序再确定性选取、weighted_pick按权重选取全零权重时回退为无权重选取、bool按 0–100 概率返回、float/integer区间内取值可带步长、shuffleFisher-Yates 洗牌等方法均通过get_value派生出确定性数值。这些原语都有对应的 parity 测试见 prng.rs 内的测试模块与仓库 tests/fixtures/parity 中的fnv1a.json、mulberry32.json、prng.json逐项比对。核心类型详解StyleStyle是一个经过校验的、不可变的风格定义包装器。你可以用Style::from_str从 JSON 字符串或Style::from_value从serde_json::Value构建一次然后复用于生成多个头像use dicebear_core::{Avatar, Style}; use serde_json::json; let style Style::from_str(definition_json)?; let avatar1 Avatar::new(style, json!({ seed: Alice }))?; let avatar2 Avatar::new(style, json!({ seed: Bob }))?;从 style.rs 可以看到构建时的完整校验序列先跑 JSON Schema 校验validate::definition再反序列化随后执行 Schema 无法表达的跨键约束校验——包括检查每个extends别名引用的组件必须存在且不能是别名禁止别名链、以及动画关键帧必须严格按at升序排列。Style内部把定义拆解为 canvas、element、component、color、meta 等子模块见 src/rust/core/src/style 目录并预计算has_animations与animation_names供选项描述器使用。AvatarAvatar是生成头像的主类型。Avatar::new接收Style与一个serde_json::Value选项对象返回ResultAvatar, Error——非法选项与循环颜色引用都会以Error形式暴露详见 error.rsError有三种变体Parse、Validation、CircularColorReference后者会携带形成闭环的颜色解析链。use dicebear_core::{Avatar, Style}; use serde_json::json; let avatar Avatar::new(style, json!({ // ... options }))?;值得注意的细节avatar.rsnull选项被当作空对象处理其他任何非对象值都会校验失败。构造即完成校验 → 解析 → 渲染之后只需通过访问方法取出不同序列化形式。OptionsDescriptorOptionsDescriptor描述某个风格接受的全部有效选项非常适合用来搭建 UI 表单或校验用户输入use dicebear_core::{OptionsDescriptor, Style}; let descriptor OptionsDescriptor::new(style).to_json();其实现见 options_descriptor.rs返回一个选项名 → 字段元数据的映射例如seedstring、sizenumber1–4096、flipenumnone/horizontal/vertical/both、scalerange0–10、borderRadiusrange0–50、rotate/translateX/translateYrange±360 / ±1000等每个组件生成${name}Variant带weighted标记的 enum与${name}Probability0–100每个颜色含隐式background生成${name}Color、${name}ColorFill、${name}ColorAngle、${name}ColorOrder等字段并保留定义中的contrastTo/notEqualTo约束。tags与动画相关选项仅在风格确实包含时才被广告出来——对静态风格传入tags/animation会被接受但不生效。方法与输出格式to_svg()/to_string()返回类型str/String以 XML 格式返回头像 SVG。Avatar同时实现了Display因此可以直接用于字符串上下文format!、println!、.to_string()let avatar Avatar::new(style, json!({ seed: Alice }))?; let svg avatar.to_svg(); // or let svg avatar.to_string();to_json()返回类型serde_json::Value包含svg与options两个键返回 SVG 与解析后的选项let avatar Avatar::new(style, json!({ seed: Alice }))?; let result avatar.to_json(); // result[svg] → svg.../svg // result[options] → { seed: Alice, ... }两个实现细节值得注意见 avatar.rs 与 resolver.rs 的注释原始 seed 会被刻意排除在解析后的选项之外防止序列化后泄露 seed而选项键的顺序、整数值序列化如size:128而不是128.0都被 tests/api.rs 中的测试锁定为与 JS 端口逐字节一致。to_data_uri()返回类型String返回头像的 data URI 形式可直接用于img标签let avatar Avatar::new(style, json!({ seed: Alice }))?; let data_uri avatar.to_data_uri(); // img src{data_uri} altAvatar /其前缀固定为data:image/svgxml;charsetutf-8,且对 SVG 内容的百分号编码完全复刻 JavaScriptencodeURIComponent的语义只保留A-Za-z0-9-_.!~*()不转义见 avatar.rs 内的encode_uri_component函数。Core options全参数参考以下选项在所有 DiceBear 实现中通用完整参考见 Core options下面是 Rust 语法中的完整形态let avatar Avatar::new(style, json!({ seed: Alice, flip: horizontal, // none, horizontal, vertical, both rotate: 10, // -360 to 360, or [min, max] range scale: 0.9, // 0 to 10 (1 original), or [min, max] range borderRadius: 50, // 0-50 (50 circle) size: 128, translateX: 0, // -1000 to 1000 (percent of canvas width) translateY: 0, // -1000 to 1000 (percent of canvas height) idRandomization: true, title: User Avatar, fontFamily: Arial, // or [Arial, Helvetica] fontWeight: 700, // 1-1000 backgroundColor: [#b6e3f4, #c0aede], backgroundColorFill: solid, // solid, linear, radial }))?;各参数的取值范围与默认值可以从 options_descriptor.rs 中一一核对选项类型取值范围说明seedstring—确定性随机数种子sizenumber1–4096输出尺寸像素flipenumnone/horizontal/vertical/both镜像翻转可传数组fontFamilystring—字体族可传数组fontWeightnumber1–1000字重可传数组scalerange0–10缩放倍数1 为原始尺寸borderRadiusrange0–50圆角50 为圆形rotaterange-360–360旋转角度translateX/translateYrange-1000–1000位移占画布宽/高的百分比idRandomizationboolean—随机化 SVG 内部 IDtitlestring—SVGtitle标题从 options.rs 可以看到一个关键归一化行为rotate、scale、borderRadius、translateX/translateY这类区间型选项接受裸数字、[n]、[min, max]三种写法——裸数字等价于min max的固定值空数组视为未设置而flip、fontFamily、fontWeight、颜色等列表型选项接受标量或数组统一归一化为列表后交给 resolver。此外tags过滤器支持category/category:value/!…否定语法详见 customize/tags 参考。动态组件与颜色选项同样以这套规则工作每个组件可以传${name}Variant带权重、${name}Probability每个颜色可以传${name}Color、${name}ColorFillsolid/linear/radial、${name}ColorAngle、${name}ColorOrderrandom/fixed。所有可用模式见 Dynamic component options。实战示例自定义背景let avatar Avatar::new(style, json!({ seed: Alice, backgroundColor: [#b6e3f4, #c0aede, #d1d4f9], }))?;固定尺寸头像使用 bottts 风格生成固定 128px、圆形裁剪的机器人头像use dicebear_core::{Avatar, Style}; use serde_json::json; let style Style::from_str(dicebear_styles::BOTTTS)?; let avatar Avatar::new(style, json!({ seed: robot-42, size: 128, borderRadius: 50, // circular avatar }))?;带变换的头像use dicebear_core::{Avatar, Style}; use serde_json::json; let style Style::from_str(dicebear_styles::AVATAAARS)?; let avatar Avatar::new(style, json!({ seed: Jane, flip: horizontal, rotate: 10, scale: 0.9, translateY: 5, }))?;同页渲染多个头像在同一页面渲染多个头像时开启idRandomization可以避免 SVG 内部 ID 冲突clipPath、渐变等 ID 若重复会导致引用串台let style Style::from_str(dicebear_styles::LORELEI)?; let avatars: VecString [alice, bob, charlie] .iter() .map(|seed| { Avatar::new(style, json!({ seed: seed, idRandomization: true })) .map(|a| a.to_svg().to_string()) }) .collect::Result_, _()?;该行为的实现细节见 tests/api.rs 中id_randomization_uses_an_ascii_word_boundary测试ID 收集使用 ASCII 词边界复刻 JavaScript\b语义随机后缀追加在每个id...之后因此多个头像间的 ID 互不干扰。加权变体选择topVariant传入一个变体名 → 权重的对象控制组件变体的选取概率let avatar Avatar::new(style, json!({ seed: Alice, topVariant: { short01: 2, short02: 2, long01: 1 }, }))?;在底层options.rs 的component_variant加权映射支持三种形态裸字符串权重 1、字符串数组每项权重 1、对象每项指定权重最终由Prng::weighted_pick按权重确定性选取若所有权重为零则回退为无权重选取保证结果仍然确定。一致性验证跨语言字节级对齐DiceBear 各语言实现共享同一套 PRNG 与渲染管线这是相同 seed 风格 选项输出逐字节相同的保证。Rust 移植版对此的验证分两层共享 fixtures仓库根目录 tests/fixtures/parity 存放了fnv1a.json、mulberry32.json、prng.json、colors.json、initials.json等基础数据以及avatars/、descriptors/、styles/目录下按风格组织的完整快照lorelei、bottts、avataaars等均在其中。Rust core 的测试直接从这些文件读取并断言输出一致见 prng.rs 的测试模块与 tests/api.rs细节锁定to_json的键序、整数值序列化、渐变 stop 顺序、ColorOrder: fixed时的颜色排列等容易被浮点精度或顺序差异破坏的点都有专门的回归测试。正因如此你可以在 Rust 服务端生成头像的同时放心地与前端 JavaScript 版见 JavaScript 集成指南混用同一套 seed两端渲染结果完全一致。许可说明DiceBear 的头像风格来自众多创作者每个创作者为自己的风格选择许可协议因此使用某个风格前请确认其授权范围。许可证总览 汇总了所有风格的许可信息一处查全。dicebear-core本身采用 MIT 许可见 src/rust/core/LICENSE。赞分享UI组件后端【免费下载链接】dicebearDiceBear is an avatar library for designers and developers. 项目地址https://gitcode.com/gh_mirrors/di/dicebear点击查看免费下载相关推荐DiceBear Go 头像库指南在 Go 服务中生成确定性 SVG 头像DiceBear Go 头像库指南在 Go 服务中生成确定性 SVG 头像 本指南围绕 DiceBear 官方 Go 语言实现 github.com/dicUI组件后端DiceBear PHP 集成指南在服务端生成确定性 SVG 头像DiceBear PHP 集成指南在服务端生成确定性 SVG 头像 DiceBear 官方为 PHP 提供了与 JavaScript 库 API 完全对齐的纯UI组件后端DiceBear 头像库入门指南多语言确定性 SVG 头像生成与集成实战DiceBear 头像库入门指南多语言确定性 SVG 头像生成与集成实战 DiceBear 是一个开源的头像Avatar生成库它把任意 seed 字符串UI组件后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考