openpyxl写入Excel单元格时HTML文本截断问题技术求助

问题概述 #

开发集成ChatGPT API的项目时，ChatGPT返回HTML格式的产品描述，使用Python的openpyxl库将该描述写入Excel多个单元格，多数单元格文本被截断，仅少数能完整保存。已排除Excel字符限制问题，怀疑是格式冲突导致。

测试代码 #

# -*- coding: utf-8 -*-
from openpyxl import load_workbook
import time

book = load_workbook("test.xlsx")
sheet_ru = book['Лист1']
#sheet_ua = book['uk']

text = '<h2><strong><span style="font-size:18px;">Посудомоечная машина Bosch SBV6ZDX49E: комфорт и надежность для вашей кухни</span></strong></h2> <p><span style="font-size:18px;">Хотите узнать, как сэкономить своё время и силы на мытье горы посуды? Встречайте посудомоечную машину Bosch SBV6ZDX49E – идеальное решение для каждой современной кухни. Сочетая в себе функциональность, стильный дизайн и передовые технологии, она станет незаменимым помощником для каждой хозяйки.</span></p> <h2><strong><span style="font-size:18px;">Преимущества посудомоечной машины Bosch SBV6ZDX49E</span></strong></h2> <p><span style="font-size:18px;">Встраиваемая посудомоечная машина Bosch SBV6ZDX49E обладает рядом характеристик, которые делают её идеальным выбором: </span></p> <ol> <li><span style="font-size:18px;">Высокая производительность и эффективность. Благодаря интеллектуальной системе управления, машина сама анализирует загрузку и оптимизирует режимы мойки, обеспечивая отличный результат каждый раз.</span></li> <li><span style="font-size:18px;">Большая вместимость. Вместительная камера с регулируемой системой корзин позволяет удобно разместить посуду разных размеров и форм, в том числе большие кастрюли и сковороды.</span></li> <li><span style="font-size:18px;">Минимальный шум. Благодаря шумоподавлению и специальным инновационным технологиям, работа машины происходит практически бесшумно, что создает комфорт во время мойки.</span></li> <li><span style="font-size:18px;">Большой выбор программ. Различные режимы мойки позволяют выбрать оптимальный вариант для любой посуды и загрязнений, что обеспечивает идеальную чистоту и сохранность вашей сантехники.</span></li> <li><span style="font-size:18px;">Экономия энергии и воды. Благодаря использованию инновационных технологий, посудомоечная машина Bosch SBV6ZDX49E является энергоэффективной и экологичной, помогая снизить расходы на коммунальные услуги и сохранить ресурсы планеты.</span></li> </ol> <h2><strong><span style="font-size:18px;">Где купить посудомоечную машину Bosch SBV6ZDX49E в Днепре</span></strong></h2> <p><span style="font-size:18px;">Если вы ищете место, где можно купить посудомоечную машину Bosch SBV6ZDX49E в Днепре по привлекательной цене, интернет-магазин Foroom является оптимальным вариантом. Мы предлагаем широкий ассортимент бытовой техники от ведущих мировых производителей по выгодным ценам. Заказать машину для мытья посуды с доставкой в Днепре можно прямо сейчас – просто добавьте товар в корзину и оформите заказ на нашем сайте. Наша команда оперативно обработает ваш запрос и осуществит доставку в кратчайшие сроки. Не упустите возможность приобрести качественную посудомоечную машину Bosch SBV6ZDX49E по лучшей цене – выбирайте Foroom!</span></p>'

for i in range(1,10):
    sheet_ru[i][0].value = text

book.save("test.xlsx")
book.close()

截断示例 #

<h2><strong><span style="font-size:18px;">Посудомоечная машина Bosch SBV6ZDX49E: комфорт и надежность для вашей кухни</span></strong></h2> <p><span style="font-size:18px;">Хотите узнать, как сэкономить своё время и силы на мытье горы посуды? Встречайте посудомоечную машину Bosch SBV6ZDX49E – идеальное решение для каждой современной кухни. Сочетая в себе функциональность, стильный дизайн и передовые технологии, она станет незаменимым помощником для каждой хозяйки.</span></p> <h2><strong><span style="font-size:18px;">Преимущества посудомоечной машины Bosch SBV6ZDX49E</span></strong></h2> <p><span style="font-size:18px;">Встраиваемая посудомоечная машина Bosch SBV6ZDX49E обладает рядом характеристик, которые делают её идеальным выбором: </span></p> <ol> <li><span style="font-size:18px;">Высокая производительность и эффективность. Благодаря интеллектуальной системе управления, машина сама анализирует загрузку и оптимизирует режимы мойки, обеспечивая отличный результат каждый раз.</span></li> <li><span style="font-size:18px;">Большая вместимость. Вместительная камера с регулируемой системой корзин позволяет удобно разместить посуду разных размеров и форм, в том числе бол *here stopped*</span></li>

原因分析 #

openpyxl默认会尝试解析单元格文本中的格式标记（如HTML标签、富文本格式），当文本包含嵌套层级较深的HTML标签（如<span>嵌套在<strong>、<h2>内，再加上列表标签<ol>、<li>）时，内部解析逻辑可能因无法处理复杂结构而提前终止写入，导致文本截断。

解决方案 #

方案1：强制以纯文本类型写入 #

通过设置单元格的data_type为's'（字符串类型），强制openpyxl将内容作为纯文本存储，不解析任何格式标记。修改后的代码如下：

# -*- coding: utf-8 -*-
from openpyxl import load_workbook

book = load_workbook("test.xlsx")
sheet_ru = book['Лист1']

text = '<h2><strong><span style="font-size:18px;">Посудомоечная машина Bosch SBV6ZDX49E: комфорт и надежность для вашей кухни</span></strong></h2> <p><span style="font-size:18px;">Хотите узнать, как сэкономить своё время и силы на мытье горы посуды? Встречайте посудомоечную машину Bosch SBV6ZDX49E – идеальное решение для каждой современной кухни. Сочетая в себе функциональность, стильный дизайн и передовые технологии, она станет незаменимым помощником для каждой хозяйки.</span></p> <h2><strong><span style="font-size:18px;">Преимущества посудомоечной машины Bosch SBV6ZDX49E</span></strong></h2> <p><span style="font-size:18px;">Встраиваемая посудомоечная машина Bosch SBV6ZDX49E обладает рядом характеристик, которые делают её идеальным выбором: </span></p> <ol> <li><span style="font-size:18px;">Высокая производительность и эффективность. Благодаря интеллектуальной системе управления, машина сама анализирует загрузку и оптимизирует режимы мойки, обеспечивая отличный результат каждый раз.</span></li> <li><span style="font-size:18px;">Большая вместимость. Вместительная камера с регулируемой системой корзин позволяет удобно разместить посуду разных размеров и форм, в том числе большие кастрюли и сковороды.</span></li> <li><span style="font-size:18px;">Минимальный шум. Благодаря шумоподавлению и специальным инновационным технологиям, работа машины происходит практически бесшумно, что создает комфорт во время мойки.</span></li> <li><span style="font-size:18px;">Большой выбор программ. Различные режимы мойки позволяют выбрать оптимальный вариант для любой посуды и загрязнений, что обеспечивает идеальную чистоту и сохранность вашей сантехники.</span></li> <li><span style="font-size:18px;">Экономия энергии и воды. Благодаря использованию инновационных технологий, посудомоечная машина Bosch SBV6ZDX49E является энергоэффективной и экологичной, помогая снизить расходы на коммунальные услуги и сохранить ресурсы планеты.</span></li> </ol> <h2><strong><span style="font-size:18px;">Где купить посудомоечную машину Bosch SBV6ZDX49E в Днепре</span></strong></h2> <p><span style="font-size:18px;">Если вы ищете место, где можно купить посудомоечную машину Bosch SBV6ZDX49E в Днепре по привлекательной цене, интернет-магазин Foroom является оптимальным вариантом. Мы предлагаем широкий ассортимент бытовой техники от ведущих мировых производителей по выгодным ценам. Заказать машину для мытья посуды с доставкой в Днепре можно прямо сейчас – просто добавьте товар в корзину и оформите заказ на нашем сайте. Наша команда оперативно обработает ваш запрос и осуществит доставку в кратчайшие сроки. Не упустите возможность приобрести качественную посудомоечную машину Bosch SBV6ZDX49E по лучшей цене – выбирайте Foroom!</span></p>'

for i in range(1,10):
    cell = sheet_ru[i][0]
    cell.data_type = 's'  # 指定为纯字符串类型，避免解析格式
    cell.value = text

book.save("test.xlsx")
book.close()

方案2：HTML转义后写入 #

如果需要保留HTML源码的可识别性，可使用html模块对文本进行转义，将特殊字符（如<、>）转换为HTML实体，避免解析冲突：

# -*- coding: utf-8 -*-
from openpyxl import load_workbook
import html

book = load_workbook("test.xlsx")
sheet_ru = book['Лист1']

text = '<h2><strong><span style="font-size:18px;">Посудомоечная машина Bosch SBV6ZDX49E: комфорт и надежность для вашей кухни</span></strong></h2> <p><span style="font-size:18px;">Хотите узнать, как сэкономить своё время и силы на мытье горы посуды? Встречайте посудомоечную машину Bosch SBV6ZDX49E – идеальное решение для каждой современной кухни. Сочетая в себе функциональность, стильный дизайн и передовые технологии, она станет незаменимым помощником для каждой хозяйки.</span></p> <h2><strong><span style="font-size:18px;">Преимущества посудомоечной машины Bosch SBV6ZDX49E</span></strong></h2> <p><span style="font-size:18px;">Встраиваемая посудомоечная машина Bosch SBV6ZDX49E обладает рядом характеристик, которые делают её идеальным выбором: </span></p> <ol> <li><span style="font-size:18px;">Высокая производительность и эффективность. Благодаря интеллектуальной системе управления, машина сама анализирует загрузку и оптимизирует режимы мойки, обеспечивая отличный результат каждый раз.</span></li> <li><span style="font-size:18px;">Большая вместимость. Вместительная камера с регулируемой системой корзин позволяет удобно разместить посуду разных размеров и форм, в том числе большие кастрюли и сковороды.</span></li> <li><span style="font-size:18px;">Минимальный шум. Благодаря шумоподавлению и специальным инновационным технологиям, работа машины происходит практически бесшумно, что создает комфорт во время мойки.</span></li> <li><span style="font-size:18px;">Большой выбор программ. Различные режимы мойки позволяют выбрать оптимальный вариант для любой посуды и загрязнений, что обеспечивает идеальную чистоту и сохранность вашей сантехники.</span></li> <li><span style="font-size:18px;">Экономия энергии и воды. Благодаря использованию инновационных технологий, посудомоечная машина Bosch SBV6ZDX49E является энергоэффективной и экологичной, помогая снизить расходы на коммунальные услуги и сохранить ресурсы планеты.</span></li> </ol> <h2><strong><span style="font-size:18px;">Где купить посудомоечную машину Bosch SBV6ZDX49E в Днепре</span></strong></h2> <p><span style="font-size:18px;">Если вы ищете место, где можно купить посудомоечную машину Bosch SBV6ZDX49E в Днепре по привлекательной цене, интернет-магазин Foroom является оптимальным вариантом. Мы предлагаем широкий ассортимент бытовой техники от ведущих мировых производителей по выгодным ценам. Заказать машину для мытья посуды с доставкой в Днепре можно прямо сейчас – просто добавьте товар в корзину и оформите заказ на нашем сайте. Наша команда оперативно обработает ваш запрос и осуществит доставку в кратчайшие сроки. Не упустите возможность приобрести качественную посудомоечную машину Bosch SBV6ZDX49E по лучшей цене – выбирайте Foroom!</span></p>'

escaped_text = html.escape(text)  # 转义HTML特殊字符

for i in range(1,10):
    sheet_ru[i][0].value = escaped_text

book.save("test.xlsx")
book.close()

说明 #

方案1适合需要完整保留原始HTML文本、不需要Excel解析格式的场景；方案2适合需要后续仍能识别HTML结构的场景，转义后的文本可通过反向转义恢复原始内容。

内容的提问来源于stack exchange，提问作者Hiro