pandas.read_sql一步读取销售数据最稳妥，自动处理列名、类型推断和空值；plotly.express生成交互式html图表，需确保时间列为datetime类型并正确配置div_id嵌入模板。
用 pandas.read_sql 从数据库读取销售数据最稳妥
直接用 sqlite3 或 psycopg2 手动 fetch 再转 DataFrame 容易丢类型（比如日期变字符串）、字段名大小写混乱，还得多写十几行。用 pandas.read_sql 一步到位，自动处理列名、类型推断和空值。
常见错误：SQL 里写 SELECT * FROM sales 却没设好数据库连接的 schema，结果报 DatabaseError: no such table —— 实际是连接到了空库或错库。务必先用 engine.execute("SELECT name FROM sqlite_master WHERE type='table'").fetchall() 确认表存在。
- MySQL/PostgreSQL 推荐用
SQLAlchemy构建engine，URL 中显式指定?charset=utf8mb4防止中文乱码 - SQLite 路径别用相对路径如
"data.db"，改用os.path.join(os.path.dirname(__file__), "data.db")，避免工作目录切换导致找不到文件 - 如果销售数据量超 10 万行，加
chunksize=5000参数分批读，防内存爆掉
用 plotly.express 生成交互式 HTML 图表不依赖前端知识
别碰 matplotlib.pyplot.savefig + 手动嵌入 HTML 的老路：静态图难缩放、没 hover 提示、移动端体验差。plotly.express 输出的是带完整 JS 的单 HTML 文件，双击就能开，销售同事用手机点开也能看趋势。
典型翻车点：px.line(df, x="date", y="revenue") 报 ValueError: Invalid value of type 'pandas._libs.tslibs.timestamps.Timestamp' —— 因为 date 列是 datetime64[ns] 类型但未转为字符串或 pd.to_datetime 显式校验过。解决方法：读取后立刻加 df["date"] = pd.to_datetime(df["date"]).dt.date。
- 时间序列图必须确保
x列是datetime类型，否则 plotly 会当离散分类处理，横轴标错 - 多指标对比（如销售额 vs 订单数）用
px.line(df, x="date", y=["revenue", "order_count"])，别手动画两条线 - 导出 HTML 时加
fig.write_html("sales_chart.html", include_plotlyjs="cdn")，减小文件体积；内网环境才用include_plotlyjs=True
把图表嵌进定制 HTML 模板要绕开 fig.to_html 的 div ID 冲突
直接 fig.to_html() 生成的代码含随机 ID（如 plot-abc123），若页面已有其他 Plotly 图，JS 初始化会互相覆盖。正确做法是用 fig.to_html(full_html=False, include_plotlyjs=False) 只取图表 div 和 script，再手动塞进模板。
例如你有个 report_template.html，里面预留了 <div id="sales-plot"></div>，那就得让 Plotly 把图渲染到这个 ID 上：
fig.update_layout(
title="月度销售趋势",
margin=dict(l=20, r=20, t=50, b=20)
)
html_div = fig.to_html(
full_html=False,
include_plotlyjs=False,
div_id="sales-plot"
)
然后用 Python 字符串替换或 string.Template 插入模板。漏掉 div_id 参数，JS 就找不到挂载点，页面空白。
- 多个图表共存时，每个
div_id必须唯一，且和模板中 ID 严格一致（区分大小写） - 若模板用了 jQuery，注意 Plotly 的
Plotly.newPlot调用时机——确保 DOM 加载完再执行，否则报Cannot read property 'layout' of null - 别在模板里重复引入
plotly.js，一个页面只引一次 CDN 链接即可
导出 HTML 后打开空白？先检查浏览器控制台里的三类错误
本地双击 HTML 打不开图表，90% 是因为浏览器安全策略阻断了本地 JS 执行，不是代码问题。打开 Chrome 控制台（F12 → Console），重点看这三类输出：
-
Not allowed to load local resource: file:///...plotly.min.js→ 改用include_plotlyjs="cdn"，或起个本地服务：python -m http.server 8000，再访问http://localhost:8000/sales_chart.html -
Cannot find element with id 'sales-plot'→ 检查模板中 div ID 是否拼写错误，或是否被 JavaScript 动态删掉了 -
Invalid date在 console 里反复出现 → 回溯到数据读取阶段，用df.dtypes确认时间列确实是datetime64，而不是object
真正麻烦的是跨部门交付：销售团队用 IE11 打不开，因为 Plotly 6+ 已放弃 IE 支持。这时候要么降级到 Plotly 5.18.0，要么明确告知“请用 Chrome / Edge 浏览器打开”。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
