lucide-nativewind

中文文档
1.67.0发布于 2026/11/04ISCTypeScriptESM + CJS构建来源已验证

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

中文使用文档
文档目录7 节
  1. 安装
  2. 用法
  3. 自定义图标
  4. 版本控制
  5. 贡献
  6. 常见问题
  7. 有哪些图标可用?

Lucide图标为React Native与NativeWind

npm NPM Downloads GitHub

代替 lucide-react-native 使用NativeWind。它提供了 Lucide图标 还有一个额外的 className 支持易于集成 NativeWind。

安装

你可以使用npm或yarn:

使用npm:

npm install lucide-nativewind

使用纱:

yarn add lucide-nativewind

用法

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

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

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

自定义图标

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

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

const MyCustomIconWithClassName = iconWithClassName(MyCustomIcon);

版本控制

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

贡献

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

常见问题

有哪些图标可用?

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

版本与发布记录

lucide-nativewind 共发布 96 个版本,首次发布于 2025/01/16;过去 12 个月发布了 68 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.67.0latest2026/11/04今天
1.66.02026/11/013 天前
1.65.02026/10/314 天前
1.64.02026/10/305 天前
1.63.02026/10/296 天前
1.62.02026/10/287 天前

关于 lucide-nativewind 的常见问题

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 和提交记录判断。