Python Emoji库的使用教程

Ne0inhk

15 Mar 2026 — 12 min read

0. 背景

Emoji库是一个Python第三方库，用于在程序中处理和使用表情符号。表情符号(Emoji)起源于日本，最初由栗田穣崇(Shigetaka Kurita)在1999年创建，用于在移动通信中传达情感和信息。随着智能手机的普及，表情符号已成为全球通用的视觉语言。

Python的emoji库提供了一种程序化方式来处理表情符号，使开发者能够在文本、日志、用户界面等场景中动态添加表情符号。

1. 作用

Emoji库主要提供以下功能：

将表情符号名称转换为实际表情符号（如 : smile:→ 😊）
将文本中的表情符号反向解析为名称（如😊 → : smile:）
统计文本中的表情符号数量
获取表情符号列表
提供表情符号的标准化名称

2. 安装Emoji库

pip install emoji

注意：正确的包名是"emoji"而不是"emoij"，这是常见的拼写错误。

3. 使用

3.1 通过名称获取表情符号

import emoji # 基本用法print(emoji.emojize(":smiling_face_with_smiling_eyes:"))print(emoji.emojize(":thumbs_up:"))# 在文本中使用 text =f"任务完成 {emoji.emojize(':check_mark:')}"print(text)

输出结果：

😊 👍 任务完成 ✔️

3.2 反向解析表情符号

print(emoji.demojize("😊"))print(emoji.demojize("👍"))# 处理包含表情符号的文本 text_with_emoji ="任务完成 ✅，继续努力 💪"print(emoji.demojize(text_with_emoji))

输出：

:smiling_face_with_smiling_eyes: :thumbs_up: 任务完成 :check_mark_button:，继续努力 :flexed_biceps:

3.3 统计和检查表情符号

# 统计文本中的表情符号数量 text ="今天心情很好 😊，工作进展顺利 👍" count = emoji.emoji_count(text)print(f"文本中包含 {count} 个表情符号")# 检查文本是否包含表情符号 has_emoji = emoji.emoji_count(text)>1print(f"文本是否包含表情符号: {has_emoji}")

输出：

文本中包含 2 个表情符号 文本是否包含表情符号: True

3.4 常见表情符号分类

3.4.1 情感表达类

emotions ={"开心":":smiling_face_with_smiling_eyes:","大笑":":grinning_face_with_big_eyes:","爱心":":red_heart:","思考":":thinking_face:","惊讶":":face_with_open_mouth:"}for name, emoji_code in emotions.items():print(f"{name}: {emoji.emojize(emoji_code)}")

输出：

开心: 😊
大笑: 😃
爱心: ❤️
思考: 🤔
惊讶: 😮

3.4.2 状态指示类

status ={"成功":":check_mark:","失败":":cross_mark:","警告":":warning:","信息":":information:","问题":":red_question_mark:"}for name, emoji_code in status.items():print(f"{name}: {emoji.emojize(emoji_code)}")

输出：
成功: ✔️
失败: ❌
警告: ⚠️
信息: ℹ️
问题: ❓

3.4.3 功能操作类

functions ={"搜索":":magnifying_glass_tilted_left:","设置":":gear:","主页":":house:","邮件":":envelope:","电话":":telephone:"}for name, emoji_code in functions.items():print(f"{name}: {emoji.emojize(emoji_code)}")

输出：
搜索: 🔍
设置: ⚙️
主页: 🏠
邮件: ✉️
电话: ☎️

4. 实际应用示例

4.1 日志记录增强

import emoji from datetime import datetime deflog_with_emoji(level, message): level_emojis ={"INFO":":information:","WARNING":":warning:","ERROR":":cross_mark:","SUCCESS":":check_mark:"} timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S") emoji_icon = emoji.emojize(level_emojis.get(level,""))returnf"[{timestamp}] [{level}] {emoji_icon}{message}"# 使用示例print(log_with_emoji("INFO","系统启动完成"))print(log_with_emoji("WARNING","内存使用率较高"))print(log_with_emoji("ERROR","数据库连接失败"))print(log_with_emoji("SUCCESS","文件上传成功"))

输出：

[2026-01-08 20:34:36] [INFO] ℹ️ 系统启动完成
[2026-01-08 20:34:36] [WARNING] ⚠️ 内存使用率较高
[2026-01-08 20:34:36] [ERROR] ❌ 数据库连接失败
[2026-01-08 20:34:36] [SUCCESS] ✔️ 文件上传成功

4.2 状态报告生成

import emoji from datetime import datetime defsafe_emojize(emoji_code, fallback=None):""" 安全地将表情符号代码转换为表情符号 如果emoji库无法解析，则使用fallback提供的表情符号 """try: result = emoji.emojize(emoji_code)# 如果转换失败（结果与输入相同），使用fallbackif result == emoji_code and fallback:return fallback return result except:return fallback or emoji_code defgenerate_status_report():# 使用双重保险机制：先尝试使用emoji库，如果失败则使用直接输入的表情符号returnf""" {safe_emojize(':bar_chart:','📊')} 系统状态报告 {safe_emojize(':check_mark:','✅')} 服务状态: 正常 {safe_emojize(':chart_with_upwards_trend:','📈')} CPU使用率: 45% {safe_emojize(':chart_with_downwards_trend:','📉')} 内存使用率: 62% {safe_emojize(':alarm_clock:','⏰')} 运行时间: 3天12小时 {safe_emojize(':information_source:','ℹ️')} 最后更新: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')} """print(generate_status_report())

输出：
📊 系统状态报告
✔️ 服务状态: 正常
📈 CPU使用率: 45%
📉 内存使用率: 62%
⏰ 运行时间: 3天12小时
ℹ️ 最后更新: 2026-01-08 20:47:19

5.完整代码

import emoji # ==================== 1. 基础使用 ====================print("=== 1. 基础使用 ===")# 1.1 通过名称获取表情符号print("1.1 通过名称获取表情符号:")print(f"搜索图标: {emoji.emojize(':magnifying_glass_tilted_left:')}")# 🔍print(f"笔记图标: {emoji.emojize(':memo:')}")# 📝print(f"笑脸: {emoji.emojize(':smiling_face_with_smiling_eyes:')}")# 😄# 1.2 在文本中使用表情符号print("\n1.2 在文本中使用表情符号:") query ="Python编程" formatted_text =f"{emoji.emojize(':magnifying_glass_tilted_left:')} 搜索查询: {query}"print(formatted_text)# ==================== 2. 常用表情符号分类 ====================print("\n=== 2. 常用表情符号分类 ===")# 2.1 搜索与信息类print("\n2.1 搜索与信息类:")# 使用直接输入的表情符号作为后备方案 search_icons ={"搜索":("🔍",":magnifying_glass_tilted_left:"),"新闻":("📰",":newspaper:"),"链接":("🔗",":link:"),"信息":("ℹ️",":information_source:"),"警告":("⚠️",":warning:"),"问题":("❓",":question:")}for name,(direct, name_code)in search_icons.items():# 尝试使用emoji库，如果失败则使用直接输入的表情符号try: emoji_result = emoji.emojize(name_code)if emoji_result == name_code:# 如果没有转换，使用直接输入的 emoji_result = direct except: emoji_result = direct print(f"{name}: {emoji_result}")# 2.2 时间与日期类print("\n2.2 时间与日期类:") time_icons ={"时钟":("🕐",":clock:"),"日历":("📅",":calendar:"),"闹钟":("⏰",":alarm_clock:"),"沙漏":("⏳",":hourglass:"),"秒表":("⏱️",":stopwatch:")}for name,(direct, name_code)in time_icons.items():try: emoji_result = emoji.emojize(name_code)if emoji_result == name_code: emoji_result = direct except: emoji_result = direct print(f"{name}: {emoji_result}")# 2.3 数据与图表类print("\n2.3 数据与图表类:") data_icons ={"图表":("📊",":bar_chart:"),"增长":("📈",":chart_with_upwards_trend:"),"下降":("📉",":chart_with_downwards_trend:"),"统计":("📋",":clipboard:"),"文件":("📄",":page_facing_up:")}for name,(direct, name_code)in data_icons.items():try: emoji_result = emoji.emojize(name_code)if emoji_result == name_code: emoji_result = direct except: emoji_result = direct print(f"{name}: {emoji_result}")# 2.4 状态与操作类print("\n2.4 状态与操作类:") status_icons ={"成功":("✅",":check_mark:"),"错误":("❌",":cross_mark:"),"警告":("⚠️",":warning:"),"信息":("ℹ️",":information_source:"),"加载":("⏳",":hourglass_not_done:"),"完成":("🏁",":checkered_flag:")}for name,(direct, name_code)in status_icons.items():try: emoji_result = emoji.emojize(name_code)if emoji_result == name_code: emoji_result = direct except: emoji_result = direct print(f"{name}: {emoji_result}")# ==================== 3. 高级功能 ====================print("\n=== 3. 高级功能 ===")# 3.1 反向解析 - 将表情符号转换为名称print("\n3.1 反向解析:") text_with_emojis ="🔍 搜索 📝 笔记 ✅ 完成"print(f"原始文本: {text_with_emojis}")print(f"解析后: {emoji.demojize(text_with_emojis)}")# 3.2 获取所有表情符号列表print("\n3.2 获取特定表情符号列表:")print("所有笑脸类表情符号:")# 使用emoji_list获取包含特定表情符号的文本列表 smileys = emoji.emoji_list(emoji.emojize(':smiling_face_with_smiling_eyes:'))print(f"找到 {len(smileys)} 个笑脸类表情符号")# 3.3 检查文本中是否包含表情符号print("\n3.3 检查文本中是否包含表情符号:") text1 ="这是一个普通文本" text2 ="这是一个包含😊表情的文本"print(f"'{text1}' 包含表情符号: {emoji.emoji_count(text1)>0}")print(f"'{text2}' 包含表情符号: {emoji.emoji_count(text2)>0}")print(f"'{text2}' 包含 {emoji.emoji_count(text2)} 个表情符号")# ==================== 4. 实际应用示例 ====================print("\n=== 4. 实际应用示例 ===")# 4.1 模拟搜索结果格式化print("\n4.1 模拟搜索结果格式化:")defformat_search_result(title, content, url):# 使用直接输入的表情符号确保兼容性returnf""" 🔍 {title} 📄 {content[:50]}... 🔗 {url} """ search_result = format_search_result("Python编程入门教程","Python是一种广泛使用的高级编程语言，具有简洁易读的语法","https://example.com/python-tutorial")print(search_result)# 4.2 模拟日志记录print("\n4.2 模拟日志记录:")deflog_message(level, message):# 使用直接输入的表情符号确保兼容性 level_icons ={"INFO":"ℹ️","WARNING":"⚠️","ERROR":"❌","SUCCESS":"✅"} icon = level_icons.get(level,"ℹ️")returnf"[{level}] {icon}{message}"print(log_message("INFO","系统启动完成"))print(log_message("WARNING","内存使用率较高"))print(log_message("ERROR","数据库连接失败"))print(log_message("SUCCESS","文件上传成功"))# 4.3 模拟状态报告print("\n4.3 模拟状态报告:")defcreate_status_report():# 使用直接输入的表情符号确保兼容性returnf""" 📊 系统状态报告 ✅ 服务状态: 正常 📈 CPU使用率: 45% 📉 内存使用率: 62% 🕐 运行时间: 3天12小时 ℹ️ 最后更新: 🕐 2023-12-26 15:30 """print(create_status_report())# ==================== 5. 直接使用表情符号（无需emoji库）====================print("\n=== 5. 直接使用表情符号（无需emoji库） ===")print("在某些情况下，可以直接在代码中输入表情符号:") direct_emoji_text =""" 🔍 搜索功能 📝 笔记功能 📊 数据分析 ⏰ 时间管理 ✅ 任务完成 ❌ 错误处理 """print(direct_emoji_text)# ==================== 6. 常见表情符号名称对照表 ====================print("\n=== 6. 常见表情符号名称对照表 ===") common_emojis ={"🔍":":magnifying_glass_tilted_left:","📝":":memo:","😄":":smiling_face_with_smiling_eyes:","📰":":newspaper:","🔗":":link:","ℹ️":":information_source:","⚠️":":warning:","❓":":question:","📅":":calendar:","⏰":":alarm_clock:","📊":":bar_chart:","📈":":chart_with_upwards_trend:","📉":":chart_with_downwards_trend:","📋":":clipboard:","📄":":page_facing_up:","✅":":check_mark:","❌":":cross_mark:","⏳":":hourglass_not_done:","🏁":":checkered_flag:"}print("表情符号与名称对照:")for symbol, name in common_emojis.items():print(f"{symbol} -> {name}")

输出：

===1. 基础使用 ===1.1 通过名称获取表情符号: 搜索图标: 🔍 笔记图标: 📝 笑脸: 😊 1.2 在文本中使用表情符号: 🔍 搜索查询: Python编程 ===2. 常用表情符号分类 ===2.1 搜索与信息类: 搜索: 🔍 新闻: 📰 链接: 🔗 信息: ℹ️ 警告: ⚠️ 问题: ❓ 2.2 时间与日期类: 时钟: 🕐 日历: 📅 闹钟: ⏰ 沙漏: ⏳ 秒表: ⏱️ 2.3 数据与图表类: 图表: 📊 增长: 📈 下降: 📉 统计: 📋 文件: 📄 2.4 状态与操作类: 成功: ✔️ 错误: ❌ 警告: ⚠️ 信息: ℹ️ 加载: ⏳ 完成: 🏁 ===3. 高级功能 ===3.1 反向解析: 原始文本: 🔍 搜索 📝 笔记 ✅ 完成 解析后: :magnifying_glass_tilted_left: 搜索 :memo: 笔记 :check_mark_button: 完成 3.2 获取特定表情符号列表: 所有笑脸类表情符号: 找到 1 个笑脸类表情符号 3.3 检查文本中是否包含表情符号: '这是一个普通文本' 包含表情符号: False '这是一个包含😊表情的文本' 包含表情符号: True '这是一个包含😊表情的文本' 包含 1 个表情符号 ===4. 实际应用示例 ===4.1 模拟搜索结果格式化: 🔍 Python编程入门教程 📄 Python是一种广泛使用的高级编程语言，具有简洁易读的语法... 🔗 https://example.com/python-tutorial 4.2 模拟日志记录: [INFO] ℹ️ 系统启动完成 [WARNING] ⚠️ 内存使用率较高 [ERROR] ❌ 数据库连接失败 [SUCCESS] ✅ 文件上传成功 4.3 模拟状态报告: 📊 系统状态报告 ✅ 服务状态: 正常 📈 CPU使用率: 45% 📉 内存使用率: 62% 🕐 运行时间: 3天12小时 ℹ️ 最后更新: 🕐 2023-12-26 15:30 ===5. 直接使用表情符号（无需emoji库） === 在某些情况下，可以直接在代码中输入表情符号: 🔍 搜索功能 📝 笔记功能 📊 数据分析 ⏰ 时间管理 ✅ 任务完成 ❌ 错误处理 ===6. 常见表情符号名称对照表 === 表情符号与名称对照: 🔍 -> :magnifying_glass_tilted_left: 📝 -> :memo: 😄 -> :smiling_face_with_smiling_eyes: 📰 -> :newspaper: 🔗 -> :link: ℹ️ -> :information_source: ⚠️ -> :warning: ❓ -> :question: 📅 -> :calendar: ⏰ -> :alarm_clock: 📊 -> :bar_chart: 📈 -> :chart_with_upwards_trend: 📉 -> :chart_with_downwards_trend: 📋 -> :clipboard: 📄 -> :page_facing_up: ✅ -> :check_mark: ❌ -> :cross_mark: ⏳ -> :hourglass_not_done: 🏁 -> :checkered_flag:

6. 常见错误用法及解决方案

6.1 表情符号名称不正确

错误: emoji.emojize(“:happy:”)
原因: 不是所有直观的名称都是有效的表情符号名称
解决方案: 使用官方标准名称或查找正确的名称

# 查找表情符号的正确名称print(emoji.demojize("😊"))# 输出: :smiling_face_with_smiling_eyes:

6.2 版本兼容性问题

问题: 某些表情符号在不同版本的emoji库中可能有不同的名称或支持情况
解决方案: 使用容错处理或直接输入表情符号

defsafe_emojize(emoji_code, fallback=None):"""安全地将表情符号代码转换为表情符号"""try: result = emoji.emojize(emoji_code)# 如果转换失败（结果与输入相同），使用后备方案if result == emoji_code and fallback:return fallback return result except:return fallback or emoji_code # 使用示例print(safe_emojize(":new_emoji:","🆕"))# 如果:new_emoji:不存在，使用🆕

6.3 编码问题

问题: 在某些环境中，表情符号可能显示为方框或问号
原因: 系统字体或终端不支持某些表情符号
解决方案:

确保系统支持Unicode表情符号

使用兼容性更好的表情符号

提供文本替代方案

defsafe_print_with_emoji(text, emoji_code, fallback_text):"""安全地打印带表情符号的文本"""try: emoji_symbol = emoji.emojize(emoji_code)print(f"{emoji_symbol}{text}")except:print(f"{fallback_text}{text}")# 使用示例 safe_print_with_emoji("任务完成",":check_mark:","[完成]")

6.4 性能问题

问题: 在处理大量文本时，频繁调用emoji库可能影响性能
解决方案:

缓存常用的表情符号

批量处理文本

在性能关键场景考虑直接使用表情符号

import emoji import time # 缓存常用表情符号classEmojiCache:def__init__(self): self._cache ={}defget(self, emoji_code):if emoji_code notin self._cache: self._cache[emoji_code]= emoji.emojize(emoji_code)return self._cache[emoji_code]# 测试缓存性能deftest_cache_performance(): emoji_cache = EmojiCache() emoji_code =":check_mark:"# 第一次调用 - 缓存未命中 start_time = time.perf_counter() result1 = emoji_cache.get(emoji_code) first_call_time = time.perf_counter()- start_time # 第二次调用 - 缓存命中 start_time = time.perf_counter() result2 = emoji_cache.get(emoji_code) second_call_time = time.perf_counter()- start_time # 直接调用emoji.emojize()进行对比 start_time = time.perf_counter() result3 = emoji.emojize(emoji_code) direct_call_time = time.perf_counter()- start_time print(f"第一次调用(缓存未命中): {result1}, 耗时: {first_call_time:.8f}秒")print(f"第二次调用(缓存命中): {result2}, 耗时: {second_call_time:.8f}秒")print(f"直接调用emoji.emojize(): {result3}, 耗时: {direct_call_time:.8f}秒")# 计算性能提升if first_call_time >0: speedup = first_call_time / second_call_time if second_call_time >0elsefloat('inf')print(f"缓存命中比首次调用快 {speedup:.2f} 倍")if direct_call_time >0: cache_speedup = direct_call_time / second_call_time if second_call_time >0elsefloat('inf')print(f"缓存命中比直接调用快 {cache_speedup:.2f} 倍")# 使用示例 emoji_cache = EmojiCache()print(emoji_cache.get(":check_mark:"))# 第一次调用会缓存print(emoji_cache.get(":check_mark:"))# 后续调用从缓存获取# 运行性能测试print("\n性能测试结果:") test_cache_performance()