# @expo-google-fonts/material-symbols 中文文档

规范地址：https://npmcn.com/package/%40expo-google-fonts/material-symbols/

版本：0\.4\.54
npm 元数据更新时间：2026-11-13T11:44:21.745Z
中文译文更新时间：2026-11-14T04:48:14.488Z
软件包许可：MIT AND Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40expo-google-fonts/material-symbols
原文对照：https://npmcn.com/package/%40expo-google-fonts/material-symbols/?lang=original
项目主页：https://github.com/expo/google-fonts/tree/master/font-packages/material-symbols#readme
源码仓库：https://github.com/expo/google-fonts

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：18.8 MB，66 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2025-03-31T14:00:18.853Z
- 最新版本发布：2026-11-13T11:44:21.546Z
- 近 30 天下载量：26153732（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：54（近 12 个月 40 个）

## 中文简介

在您的 Expo 应用程序中使用来自 Google 字体的材料符号字体家族

## 安装

```sh
npm install @expo-google-fonts/material-symbols
```

也可以使用：`pnpm add @expo-google-fonts/material-symbols`、`yarn add @expo-google-fonts/material-symbols`、`bun add @expo-google-fonts/material-symbols`

## README

# @expo-google-fonts/ 物质符号

![npm version](https://flat.badgen.net/npm/v/@expo-google-fonts/material-symbols) ![license](https://flat.badgen.net/github/license/expo/google-fonts) ![publish size](https://flat.badgen.net/packagephobia/install/@expo-google-fonts/material-symbols) ![publish size](https://flat.badgen.net/packagephobia/publish/@expo-google-fonts/material-symbols)

此软件包允许您使用 [**材料符号**](https://fonts.google.com/specimen/Material+Symbols) 字体家族从 [谷歌字体](https://fonts.google.com/) 在你的博览会应用.

## 材料符号

![Material Symbols](https://npmcn.com/package/%40expo-google-fonts/material-symbols/font-family.png)

此字体家族包含 [14个样式](https://npmcn.com/package/%40expo-google-fonts/material-symbols/#readme--gallery)。 。 。 .

-   `MaterialSymbols_100Thin`
-   `MaterialSymbols_200ExtraLight`
-   `MaterialSymbols_300Light`
-   `MaterialSymbols_400Regular`
-   `MaterialSymbols_500Medium`
-   `MaterialSymbols_600SemiBold`
-   `MaterialSymbols_700Bold`
-   `MaterialSymbols_100Thin_Filled`
-   `MaterialSymbols_200ExtraLight_Filled`
-   `MaterialSymbols_300Light_Filled`
-   `MaterialSymbols_400Regular_Filled`
-   `MaterialSymbols_500Medium_Filled`
-   `MaterialSymbols_600SemiBold_Filled`
-   `MaterialSymbols_700Bold_Filled`

## 使用量

从您的 Expo 项目的根目录中的 shell 中运行此命令, 以便将字体家族包添加到您的工程中

```sh
npx expo install @expo-google-fonts/material-symbols expo-font
```

现在将这样的代码添加到您的工程中

```js
import { Text, View } from "react-native";
import { useFonts } from '@expo-google-fonts/material-symbols/useFonts';
import { MaterialSymbols_100Thin } from '@expo-google-fonts/material-symbols/100Thin';
import { MaterialSymbols_200ExtraLight } from '@expo-google-fonts/material-symbols/200ExtraLight';
import { MaterialSymbols_300Light } from '@expo-google-fonts/material-symbols/300Light';
import { MaterialSymbols_400Regular } from '@expo-google-fonts/material-symbols/400Regular';
import { MaterialSymbols_500Medium } from '@expo-google-fonts/material-symbols/500Medium';
import { MaterialSymbols_600SemiBold } from '@expo-google-fonts/material-symbols/600SemiBold';
import { MaterialSymbols_700Bold } from '@expo-google-fonts/material-symbols/700Bold';
import { MaterialSymbols_100Thin_Filled } from '@expo-google-fonts/material-symbols/100Thin_Filled';
import { MaterialSymbols_200ExtraLight_Filled } from '@expo-google-fonts/material-symbols/200ExtraLight_Filled';
import { MaterialSymbols_300Light_Filled } from '@expo-google-fonts/material-symbols/300Light_Filled';
import { MaterialSymbols_400Regular_Filled } from '@expo-google-fonts/material-symbols/400Regular_Filled';
import { MaterialSymbols_500Medium_Filled } from '@expo-google-fonts/material-symbols/500Medium_Filled';
import { MaterialSymbols_600SemiBold_Filled } from '@expo-google-fonts/material-symbols/600SemiBold_Filled';
import { MaterialSymbols_700Bold_Filled } from '@expo-google-fonts/material-symbols/700Bold_Filled';

export default () => {

  let [fontsLoaded] = useFonts({
    MaterialSymbols_100Thin, 
    MaterialSymbols_200ExtraLight, 
    MaterialSymbols_300Light, 
    MaterialSymbols_400Regular, 
    MaterialSymbols_500Medium, 
    MaterialSymbols_600SemiBold, 
    MaterialSymbols_700Bold, 
    MaterialSymbols_100Thin_Filled, 
    MaterialSymbols_200ExtraLight_Filled, 
    MaterialSymbols_300Light_Filled, 
    MaterialSymbols_400Regular_Filled, 
    MaterialSymbols_500Medium_Filled, 
    MaterialSymbols_600SemiBold_Filled, 
    MaterialSymbols_700Bold_Filled
  });

  let fontSize = 24;
  let paddingVertical = 6;

  if (!fontsLoaded) {
    return null;
  } else {
    return (
      <View style={{ flex: 1, justifyContent: "center", alignItems: "center" }}>
        <Text style={{
          fontSize,
          paddingVertical,
          // Note the quoting of the value for `fontFamily` here; it expects a string!
          fontFamily: "MaterialSymbols_100Thin"
        }}>
          Material Symbols Thin
        </Text>
        <Text style={{
          fontSize,
          paddingVertical,
          // Note the quoting of the value for `fontFamily` here; it expects a string!
          fontFamily: "MaterialSymbols_200ExtraLight"
        }}>
          Material Symbols Extra Light
        </Text>
        <Text style={{
          fontSize,
          paddingVertical,
          // Note the quoting of the value for `fontFamily` here; it expects a string!
          fontFamily: "MaterialSymbols_300Light"
        }}>
          Material Symbols Light
        </Text>
        <Text style={{
          fontSize,
          paddingVertical,
          // Note the quoting of the value for `fontFamily` here; it expects a string!
          fontFamily: "MaterialSymbols_400Regular"
        }}>
          Material Symbols Regular
        </Text>
        <Text style={{
          fontSize,
          paddingVertical,
          // Note the quoting of the value for `fontFamily` here; it expects a string!
          fontFamily: "MaterialSymbols_500Medium"
        }}>
          Material Symbols Medium
        </Text>
        <Text style={{
          fontSize,
          paddingVertical,
          // Note the quoting of the value for `fontFamily` here; it expects a string!
          fontFamily: "MaterialSymbols_600SemiBold"
        }}>
          Material Symbols Semi Bold
        </Text>
        <Text style={{
          fontSize,
          paddingVertical,
          // Note the quoting of the value for `fontFamily` here; it expects a string!
          fontFamily: "MaterialSymbols_700Bold"
        }}>
          Material Symbols Bold
        </Text>
        <Text style={{
          fontSize,
          paddingVertical,
          // Note the quoting of the value for `fontFamily` here; it expects a string!
          fontFamily: "MaterialSymbols_100Thin_Filled"
        }}>
          Material Symbols Thin Filled
        </Text>
        <Text style={{
          fontSize,
          paddingVertical,
          // Note the quoting of the value for `fontFamily` here; it expects a string!
          fontFamily: "MaterialSymbols_200ExtraLight_Filled"
        }}>
          Material Symbols Extra Light Filled
        </Text>
        <Text style={{
          fontSize,
          paddingVertical,
          // Note the quoting of the value for `fontFamily` here; it expects a string!
          fontFamily: "MaterialSymbols_300Light_Filled"
        }}>
          Material Symbols Light Filled
        </Text>
        <Text style={{
          fontSize,
          paddingVertical,
          // Note the quoting of the value for `fontFamily` here; it expects a string!
          fontFamily: "MaterialSymbols_400Regular_Filled"
        }}>
          Material Symbols Filled
        </Text>
        <Text style={{
          fontSize,
          paddingVertical,
          // Note the quoting of the value for `fontFamily` here; it expects a string!
          fontFamily: "MaterialSymbols_500Medium_Filled"
        }}>
          Material Symbols Medium Filled
        </Text>
        <Text style={{
          fontSize,
          paddingVertical,
          // Note the quoting of the value for `fontFamily` here; it expects a string!
          fontFamily: "MaterialSymbols_600SemiBold_Filled"
        }}>
          Material Symbols Semi Bold Filled
        </Text>
        <Text style={{
          fontSize,
          paddingVertical,
          // Note the quoting of the value for `fontFamily` here; it expects a string!
          fontFamily: "MaterialSymbols_700Bold_Filled"
        }}>
          Material Symbols Bold Filled
        </Text>
      </View>
    );
  }
};
```

## QQ 画廊

|  |  |  |
| --- | --- | --- |
| ![MaterialSymbols\_100Thin](https://npmcn.com/package/%40expo-google-fonts/material-symbols/100Thin/MaterialSymbols_100Thin.ttf.png) | ![MaterialSymbols\_200ExtraLight](https://npmcn.com/package/%40expo-google-fonts/material-symbols/200ExtraLight/MaterialSymbols_200ExtraLight.ttf.png) | ![MaterialSymbols\_300Light](https://npmcn.com/package/%40expo-google-fonts/material-symbols/300Light/MaterialSymbols_300Light.ttf.png) |
| ![MaterialSymbols\_400Regular](https://npmcn.com/package/%40expo-google-fonts/material-symbols/400Regular/MaterialSymbols_400Regular.ttf.png) | ![MaterialSymbols\_500Medium](https://npmcn.com/package/%40expo-google-fonts/material-symbols/500Medium/MaterialSymbols_500Medium.ttf.png) | ![MaterialSymbols\_600SemiBold](https://npmcn.com/package/%40expo-google-fonts/material-symbols/600SemiBold/MaterialSymbols_600SemiBold.ttf.png) |
| ![MaterialSymbols\_700Bold](https://npmcn.com/package/%40expo-google-fonts/material-symbols/700Bold/MaterialSymbols_700Bold.ttf.png) | ![MaterialSymbols\_100Thin\_Filled](https://npmcn.com/package/%40expo-google-fonts/material-symbols/100Thin_Filled/MaterialSymbols_100Thin_Filled.ttf.png) | ![MaterialSymbols\_200ExtraLight\_Filled](https://npmcn.com/package/%40expo-google-fonts/material-symbols/200ExtraLight_Filled/MaterialSymbols_200ExtraLight_Filled.ttf.png) |
| ![MaterialSymbols\_300Light\_Filled](https://npmcn.com/package/%40expo-google-fonts/material-symbols/300Light_Filled/MaterialSymbols_300Light_Filled.ttf.png) | ![MaterialSymbols\_400Regular\_Filled](https://npmcn.com/package/%40expo-google-fonts/material-symbols/400Regular_Filled/MaterialSymbols_400Regular_Filled.ttf.png) | ![MaterialSymbols\_500Medium\_Filled](https://npmcn.com/package/%40expo-google-fonts/material-symbols/500Medium_Filled/MaterialSymbols_500Medium_Filled.ttf.png) |
| ![MaterialSymbols\_600SemiBold\_Filled](https://npmcn.com/package/%40expo-google-fonts/material-symbols/600SemiBold_Filled/MaterialSymbols_600SemiBold_Filled.ttf.png) | ![MaterialSymbols\_700Bold\_Filled](https://npmcn.com/package/%40expo-google-fonts/material-symbols/700Bold_Filled/MaterialSymbols_700Bold_Filled.ttf.png) |  |

## 开发期间的使用

如果您尝试了许多不同的字体, 您可以尝试使用 [`@expo-google-fonts/dev` 软件包](https://github.com/expo/google-fonts/tree/master/font-packages/dev#readme)。 。 。 .

您可以导入 _任意_ 任何 Expo Google 字体包的字体样式。 它会在运行时将字体加载到网络上,而不是将资产作为文件添加到您的项目中,因此您的应用程序在启动时可能需要更长的时间才能实现交互,但是在任意风格的游戏中极方便.

## 许可证

这个 `@expo-google-fonts/material-symbols` 软件包及其代码在麻省理工学院许可下发布.

Google字体目录中的所有字体都是免费和开源的.

检查 [Google 字体上的材料符号页面](https://fonts.google.com/specimen/Material+Symbols) 该字体家族的特定许可证.

您可以在您的产品和项目中自由使用这些字体 -- -- 打印或数字、商业或其他。 然而,不能自行销售字体. 这不是法律建议,请考虑咨询律师 并查看所有细节的完整许可证.

## 链接

-   [Google 字体上的材料符号](https://fonts.google.com/specimen/Material+Symbols)
-   [谷歌字体](https://fonts.google.com/)
-   [Npm 上的这个软件包](https://www.npmjs.com/package/@expo-google-fonts/material-symbols)
-   [GitHub 上的这个软件包](https://github.com/expo/google-fonts/tree/master/font-packages/material-symbols)
-   [GitHub 上的博览会 Google 字体项目](https://github.com/expo/google-fonts)
-   [`@expo-google-fonts/dev` 开发软件包](https://github.com/expo/google-fonts/tree/master/font-packages/dev)

## 捐款

贡献是非常受欢迎的! 这个整个目录,包括您现在所读的内容,都是由代码生成的. 请不直接提交公关文件,而是向 [生成器](https://github.com/expo/google-fonts/tree/master/packages/generator) 换句话说.

## 常见问题

### @expo-google-fonts/material-symbols 是什么？

在您的 Expo 应用程序中使用来自 Google 字体的材料符号字体家族

### 如何安装 @expo-google-fonts/material-symbols？

在项目目录运行 npm install @expo-google-fonts/material-symbols，或使用 pnpm add / yarn add / bun add。

### @expo-google-fonts/material-symbols 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @expo-google-fonts/material-symbols 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @expo-google-fonts/material-symbols 可以商用吗？

@expo-google-fonts/material-symbols 使用 MIT AND Apache-2\.0 许可。声明的许可为 MIT AND Apache-2\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @expo-google-fonts/material-symbols 的下载量有多少？

根据 npm 官方下载统计，@expo-google-fonts/material-symbols 在 2026/10/14 – 2026/11/12 这 30 天内被下载 26,153,732 次，日均约 871,791 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @expo-google-fonts/material-symbols 还在维护吗？

最新版本 0\.4\.54 发布于 2026/11/13（今天）；至今共发布 54 个版本，其中过去 12 个月发布了 40 个；首次发布于 2025/03/31。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。