如何在Plotly中设置图表标题和坐标轴标签？

Question

**问题描述：** 在使用 Plotly 绘制图表时，如何正确设置图表的主标题（Title）、X轴和Y轴的标签（Axis Labels），以提升图表可读性和专业性？常见做法是否适用于不同类型的图表（如散点图、柱状图、折线图）？是否存在布局（layout）配置上的注意事项，例如字体、位置及中文支持等问题？

Answer 1

一、Plotly 图表标题与轴标签设置的基本方法

在使用 Plotly 进行数据可视化时，正确设置主标题（Title）和坐标轴标签（Axis Labels）是提升图表可读性和专业性的关键一步。Plotly 支持多种图表类型，包括散点图（Scatter）、柱状图（Bar）、折线图（Line）等，它们的配置方式基本一致。

• 主标题设置： 使用 title 参数设置全局标题。
• X轴标签设置： 通过 xaxis_title 设置 X 轴标签。
• Y轴标签设置： 使用 yaxis_title 设置 Y 轴标签。

import plotly.express as px

df = px.data.iris()
fig = px.scatter(df, x='sepal_width', y='sepat_length', title='鸢尾花散点图')
fig.update_layout(
    xaxis_title='花瓣宽度',
    yaxis_title='花瓣长度'
)
fig.show()

二、不同图表类型的适用性分析

尽管图表类型各异，但 Plotly 的布局配置接口高度统一。以下是一些常见图表类型及其推荐做法：

图表类型	主标题建议	X轴标签建议	Y轴标签建议
散点图（Scatter）	描述变量关系	自变量名称	因变量名称
柱状图（Bar）	突出比较主题	分类名称	数值单位
折线图（Line）	趋势或时间序列	时间或阶段	指标值

graph TD A[开始] --> B[选择图表类型] B --> C{是否为多轴?} C -->|是| D[使用 layout.xaxis / layout.yaxis 配置] C -->|否| E[使用通用 axis_title 配置] D --> F[完成图表配置] E --> F

三、布局配置进阶：字体、位置与中文支持

为了进一步提升图表的专业性，开发者常常需要对布局进行更细致的控制，例如字体大小、标题位置、语言支持等。

• 字体设置： 使用 font 字典控制整体字体风格。
• 标题位置调整： 使用 title_x 和 title_y 控制标题偏移。
• 中文支持： 确保系统中安装了中文字体，并在 layout.font.family 中指定。

fig.update_layout(
    title='鸢尾花散点图',
    title_x=0.5,
    xaxis_title='花瓣宽度 (cm)',
    yaxis_title='花瓣长度 (cm)',
    font=dict(family="SimHei", size=14),
    template="plotly_white"
)

注意：若图表中出现中文乱码，应检查运行环境是否支持 SimHei、Microsoft YaHei 等中文字体。

四、实际应用中的最佳实践与注意事项

以下是几个在实际项目中常见的注意事项与优化建议：

• 避免标题过长，建议保持简洁明了。
• 对于多子图（subplots），每个子图应独立设置对应的轴标签。
• 使用 template 模板统一视觉风格。
• 在 Web 应用中嵌入 Plotly 图表时，确保前端页面也加载了所需的字体资源。

from plotly.subplots import make_subplots

fig = make_subplots(rows=1, cols=2)
fig.add_scatter(y=[1,3,2], x=[1,2,3], row=1, col=1)
fig.add_bar(y=[2,1,3], x=[1,2,3], row=1, col=2)

fig.update_layout(
    title='双图表对比展示',
    xaxis_title='X 值',
    yaxis_title='Y 值',
    xaxis2_title='类别编号',
    yaxis2_title='频数统计'
)
fig.show()