# lucide-nativewind 中文文档

规范地址：https://npmcn.com/package/lucide-nativewind/

版本：1\.67\.0
npm 元数据更新时间：2026-11-04T02:10:40.106Z
中文译文更新时间：2026-11-04T02:37:41.501Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/lucide-nativewind
原文对照：https://npmcn.com/package/lucide-nativewind/?lang=original
项目主页：https://github.com/a16n-dev/lucide-nativewind#readme
源码仓库：https://github.com/a16n-dev/lucide-nativewind

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

- 包体积（解压后）：5.6 MB，13740 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：react ^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0，react-dom ^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0
- 首次发布：2025-01-16T02:49:21.472Z
- 最新版本发布：2026-11-04T02:10:39.774Z
- 已发布版本数：96（近 12 个月 68 个）

## 中文简介

React Native的Lucide图标，以及nativewind的ClassName道具

## 安装

```sh
npm install lucide-nativewind
```

也可以使用：`pnpm add lucide-nativewind`、`yarn add lucide-nativewind`、`bun add lucide-nativewind`

## README

# Lucide图标为React Native与NativeWind

[![npm](https://img.shields.io/npm/v/lucide-nativewind?color=blue)](https://www.npmjs.com/package/lucide-nativewind) ![NPM Downloads](https://img.shields.io/npm/dw/lucide-nativewind) [![GitHub](https://img.shields.io/github/license/lucide-icons/lucide)](https://lucide.dev/license)

代替 `lucide-react-native` 使用NativeWind。它提供了 [Lucide图标](https://lucide.dev/) 还有一个额外的 `className` 支持易于集成 [NativeWind](https://www.nativewind.dev/)。

## 安装

你可以使用npm或yarn：

使用npm:

```bash
npm install lucide-nativewind
```

使用纱:

```bash
yarn add lucide-nativewind
```

## 用法

`lucide-nativewind` 是用ES模块构建的，所以它是完全可以摇树的。每个图标都可以作为react组件导入。

所有图标都可以导入，就像使用 `lucide-react-native` 包

```diff
- import { ArrowLeftCircleIcon } from 'lucide-react-native';
+ import { ArrowLeftCircleIcon } from 'lucide-nativewind';
```

## 自定义图标

自定义图标可以用 `iconWithClassName` 添加 `className` 道具。

```jsx
import { iconWithClassName } from 'lucide-nativewind';
import MyCustomIcon from './MyCustomIcon';

const MyCustomIconWithClassName = iconWithClassName(MyCustomIcon);
```

## 版本控制

版本自动保持同步 `lucide-react-native`

## 贡献

欢迎所有贡献。对新/更新图标的贡献/请求应该直接提交给lucide项目： [https://github.com/lucide-icons/lucide](https://github.com/lucide-icons/lucide)

## 常见问题

### 有哪些图标可用？

所有lucide图标都是可用的，当新的图标被添加到lucide时，这个包将被更新。这个包不打算添加任何额外的或自定义图标。

## 常见问题

### lucide-nativewind 是什么？

React Native的Lucide图标，以及nativewind的ClassName道具

### 如何安装 lucide-nativewind？

在项目目录运行 npm install lucide-nativewind，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0）、react-dom（^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### lucide-nativewind 支持 TypeScript 吗？

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

### lucide-nativewind 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### lucide-nativewind 可以商用吗？

lucide-nativewind 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### lucide-nativewind 还在维护吗？

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