Python Emoji 库使用教程 | 极客日志

Python

Python Emoji 库使用教程

Python emoji 第三方库的安装与使用方法。涵盖表情符号名称转换、反向解析、数量统计及分类获取功能。通过日志记录增强、状态报告生成等实际案例展示应用场景，并提供常见错误（如名称错误、版本兼容、编码问题）的解决方案及性能优化建议（缓存机制）。

修罗发布于 2026/3/30更新于 2026/4/131 浏览

0. 背景

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

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

1. 作用

Emoji 库主要提供以下功能：

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

2. 安装 Emoji 库

pip install emoji

import emoji

# 基本用法
print(emoji.emojize(":smiling_face_with_smiling_eyes:"))
print(emoji.emojize(":thumbs_up:"))

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

😊 👍 任务完成 ✔️

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:

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

# 检查文本是否包含表情符号
has_emoji = emoji.emoji_count(text) > 1
print(f"文本是否包含表情符号：{has_emoji}")

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

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)}")

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

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

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

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

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

import emoji
from datetime import datetime

def log_with_emoji(level, message):
    level_emojis = {
        "INFO": ":information_source:",
        "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, ""))
    return f"[{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] ✔️ 文件上传成功

import emoji
from datetime import datetime

def safe_emojize(emoji_code, fallback=None):
    """安全地将表情符号代码转换为表情符号
    如果 emoji 库无法解析，则使用 fallback 提供的表情符号"""
    try:
        result = emoji.emojize(emoji_code)
        # 如果转换失败（结果与输入相同），使用 fallback
        if result == emoji_code and fallback:
            return fallback
        return result
    except:
        return fallback or emoji_code

def generate_status_report():
    # 使用双重保险机制：先尝试使用 emoji 库，如果失败则使用直接输入的表情符号
    return f"""
    {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

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():
    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("所有笑脸类表情符号:")
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 模拟搜索结果格式化:")
def format_search_result(title, content, url):
    # 使用直接输入的表情符号确保兼容性
    return f""" 🔍 {title} 📄 {content[:50]}... 🔗 {url} """

search_result = format_search_result(
    "Python 编程入门教程",
    "Python 是一种广泛使用的高级编程语言，具有简洁易读的语法",
    "https://example.com/python-tutorial"
)
print(search_result)

# 4.2 模拟日志记录
print("\n4.2 模拟日志记录:")
def log_message(level, message):
    # 使用直接输入的表情符号确保兼容性
    level_icons = {"INFO": "ℹ️", "WARNING": "⚠️", "ERROR": "❌", "SUCCESS": "✅"}
    icon = level_icons.get(level, "ℹ️")
    return f"[{level}] {icon}{message}"

print(log_message("INFO", "系统启动完成"))
print(log_message("WARNING", "内存使用率较高"))
print(log_message("ERROR", "数据库连接失败"))
print(log_message("SUCCESS", "文件上传成功"))

# 4.3 模拟状态报告
print("\n4.3 模拟状态报告:")
def create_status_report():
    # 使用直接输入的表情符号确保兼容性
    return f""" 📊 系统状态报告 ✅ 服务状态：正常 📈 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:

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

def safe_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:不存在，使用🆕

def safe_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:", "[完成]")

import emoji
import time

# 缓存常用表情符号
class EmojiCache:
    def __init__(self):
        self._cache = {}

    def get(self, emoji_code):
        if emoji_code not in self._cache:
            self._cache[emoji_code] = emoji.emojize(emoji_code)
        return self._cache[emoji_code]

# 测试缓存性能
def test_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 > 0 else float('inf')
        print(f"缓存命中比首次调用快 {speedup:.2f} 倍")
    if direct_call_time > 0:
        cache_speedup = direct_call_time / second_call_time if second_call_time > 0 else float('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()

✔️ ✔️ 性能测试结果：第一次调用 (缓存未命中): ✔️, 耗时：0.00000736 秒 第二次调用 (缓存命中): ✔️, 耗时：0.00000029 秒 直接调用 emoji.emojize(): ✔️, 耗时：0.00000432 秒 缓存命中比首次调用快 25.57 倍 缓存命中比直接调用快 15.01 倍

Python Emoji 库使用教程

0. 背景

1. 作用

2. 安装 Emoji 库

3. 使用

3.1 通过名称获取表情符号

3.2 反向解析表情符号

3.3 统计和检查表情符号

3.4 常见表情符号分类

3.4.1 情感表达类

3.4.2 状态指示类

3.4.3 功能操作类

4. 实际应用示例

4.1 日志记录增强

4.2 状态报告生成

5. 完整代码

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

6.1 表情符号名称不正确

6.2 版本兼容性问题

6.3 编码问题

6.4 性能问题

更多推荐文章

相关免费在线工具

Python Emoji 库使用教程

0. 背景

1. 作用

2. 安装 Emoji 库

3. 使用

3.1 通过名称获取表情符号

3.2 反向解析表情符号

3.3 统计和检查表情符号

3.4 常见表情符号分类

3.4.1 情感表达类

3.4.2 状态指示类

3.4.3 功能操作类

4. 实际应用示例

4.1 日志记录增强

4.2 状态报告生成

5. 完整代码

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

6.1 表情符号名称不正确

6.2 版本兼容性问题

6.3 编码问题

6.4 性能问题

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具