当前位置：首页 > news >正文

KindEditor处理政府公文修订记录保留需求

news 2026/7/30 6:06:18

《Word一键转存历险记：一个穷学生的CMS升级之路》

寻找解决方案的奇幻旅程

第一天：初探Word粘贴黑科技

作为一名福建某高校的计科大三狗（啊不是，学生），我正在给我的CMS新闻管理系统做升级。需求很简单（才怪）：让用户能从Word一键粘贴内容，还能自动上传图片到我的阿里云OSS，同时保留所有花里胡哨的格式！

开始在网上疯狂搜索：“Word粘贴保留格式”、“KindEditor图片自动上传”…

“免费”是我的关键词，毕竟预算只有99元（连顿像样的火锅都吃不起）。

发现1：CKEditor有Paste from Word插件，但要付费（钱包在哭泣）

发现2：TinyMCE貌似支持，但集成到KindEditor要魔改（我太难了）

发现3：国内某个叫WangEditor的，文档全是中文（感动！），但功能有限

柳暗花明又一村

在GitHub上挖到宝藏了！一个叫mammoth.js的开库可以把Word转HTML，还能处理图片！

// 前端示例代码 - 使用mammoth.js处理Word文档importmammothfrom"mammoth";functionhandleWordFile(file){constreader=newFileReader();reader.onload=function(event){constarrayBuffer=event.target.result;mammoth.extractRawText({arrayBuffer:arrayBuffer}).then(function(result){// 获取纯文本lettext=result.value;// 处理图片letimages=result.messages.filter(m=>m.type==="image").map(img=>uploadImageToOSS(img));// 自定义上传函数}).catch(function(error){console.error(error);});};reader.readAsArrayBuffer(file);}

后端PHP处理大冒险

既然前端能解析Word了，后端要负责把图片传到OSS：

// PHP后端处理图片上传到阿里云OSSuseOSS\OssClient;useOSS\Core\OssException;functionuploadToOSS($imageData,$fileName){$accessKeyId="您的AccessKeyId";$accessKeySecret="您的AccessKeySecret";$endpoint="您的Endpoint";$bucket="您的Bucket";try{$ossClient=newOssClient($accessKeyId,$accessKeySecret,$endpoint);$result=$ossClient->putObject($bucket,"news/".$fileName,$imageData);return$result['info']['url'];}catch(OssException$e){error_log("OSS上传失败: ".$e->getMessage());returnfalse;}}

KindEditor魔改计划

KindEditor默认不支持这么高级的功能，得给它动手术：

// 在KindEditor初始化时添加自定义按钮KindEditor.plugin('wordpaste',function(K){vareditor=this;editor.clickToolbar('wordpaste',function(){// 创建隐藏的file inputvarinput=document.createElement('input');input.type='file';input.accept='.doc,.docx';input.onchange=function(e){handleWordFile(e.target.files[0],function(html){editor.insertHtml(html);});};input.click();});});

踩坑记录与突破

Word公式处理：MathType公式简直是大BOSS！最终用html-to-docx库把公式转成图片解决
样式保留：发现直接粘贴会丢失样式，改用mammoth.js的convertToHtml方法并自定义样式映射
跨平台兼容：在Linux服务器上GD库没安装导致图片处理失败（熬夜到凌晨3点才解决）

成果展示

经过两周的奋战（和无数杯速溶咖啡），我的CMS现在可以：
✅ Word一键粘贴保留格式
✅ 图片自动上传到OSS
✅ 支持表格、公式等复杂内容
✅ 跨平台兼容性良好

全部花费：0元（感谢开源社区！省下的99元可以吃顿好的了）

致同行的小伙伴

如果你也在做类似的功能，欢迎加入我们的接单交流群（QQ群：223813913）。我们可以：

分享开发经验
接外包项目
吐槽坑爹的需求
互相安利好用的工具库

最后送上学长的忠告：遇到技术难题不要慌，先喝杯奶茶压压惊，然后去GitHub、StackOverflow上找找，答案总比问题多！

上传工具栏插件文件夹

上传插件文件夹

控件初始化

在head中引入组件文件
注意，不要重复引入jquery，如果您的页面已经引入了jquery这里就不要再引入jquery 1.4了。

WordPaster For KindEditor-4.x # 初始化组件 WordPaster.getInstance({ui:{render:"wdpst"}//目标容器，一般为div});

设置快捷键

将插件添加到工具栏，并挂载KindEditor的Ctrl+V快捷键事件

vareditor;KindEditor.ready(function(K){editor=K.create('#content1',{items:['wordpaster','importwordtoimg','netpaster','wordimport','excelimport','pptimport','pdfimport','|','importword','exportword','importpdf','|'],afterCreate:function(){WordPaster.getInstance().SetEditor(this);varself=this;//自定义 Ctrl + V 事件。KindEditor.ctrl(self.edit.doc,'V',function(){WordPaster.getInstance().Paste();});}});});