color-names

环境要求

• Node.js 环境（需使用 npm 安装依赖）
• 仅作为数据处理，无其他运行时依赖
• 浏览器端使用需注意全量包体积约 1.22 MB
• 数据集本身为纯数据仓库，不需要独立部署服务

安装与启动步骤

1. 1安装 npm 包

   在项目目录下通过 npm 安装 color-name-list 包，安装后即可在 JS/TS 中导入使用。

   npm install color-name-list

   复制

2. 2导入并查询颜色

   按 hex 值在 colornames 数组中查找对应颜色名称，示例查找 #ffffff 得到 White。

   import { colornames } from 'color-name-list';
   
   const white = colornames.find((c) => c.hex === '#ffffff');
   console.log(white?.name); // => White

   复制

3. 3改用精简子集

   默认导入的是全量列表（1.22 MB）。如需减小体积，可改为导入 color-name-list/bestof 或 color-name-list/short 子集。

4. 4查看其他语言用法

   社区维护了多语言实现，可参考仓库 docs 目录下对应的使用文档进行集成。

如何确认成功

运行示例代码后，控制台输出 White，即表示数据集导入与查询正常。

常见问题

注意事项

• 本项目是纯数据仓库，无需部署服务器，作为依赖库引入即可使用。
• 导入全量列表时包体积约 1.22 MB，前端项目建议选用 bestof 或 short 子集。
• 数据集共收录 31918 个唯一颜色名称，并配有自动化测试保证数据质量。
• README 未提供命令行工具或本地服务启动方式，不要尝试自行运行服务。