CKEditor 5官方构建中特殊字符与源码按钮失效原因及修复

特殊字符列表为空 #

原因 #

Decoupled Document基础包仅包含SpecialCharacters核心插件框架，但未默认集成具体的字符子集（如基础符号、拉丁字符等）。如果在构建时只勾选了核心插件而未选择任何字符子集，就会显示空列表。

修复 #

1. 打开CKEditor官方在线构建器，加载原构建配置或重新选择Decoupled Document作为模板。
2. 在插件列表的「Special Characters」分类下，除核心SpecialCharacters外，至少勾选一个字符子集插件（如SpecialCharactersBasic、SpecialCharactersLatin）。
3. 重新构建并替换项目中的CKEditor文件。
4. 自定义集成场景下可手动补充插件：

   import { SpecialCharacters, SpecialCharactersBasic } from '@ckeditor/ckeditor5-special-characters';
   
   DecoupledEditor
       .create( document.querySelector( '#editor' ), {
           plugins: [ SpecialCharacters, SpecialCharactersBasic, /* 其他已用插件 */ ],
           toolbar: [ 'specialCharacters', /* 其他工具栏项 */ ]
       } )
   

源码编辑按钮失效 #

原因 #

Decoupled Document默认不包含SourceEditing插件，若构建时未手动勾选该插件，工具栏上的源码按钮仅为占位，无实际功能；若已勾选但未在工具栏配置中添加sourceEditing项，也会导致按钮失效。

修复 #

1. 进入CKEditor官方在线构建器，加载原配置，勾选「Source Editing」插件。
2. 在工具栏编辑界面确认sourceEditing按钮已添加到工具栏。
3. 重新构建并替换现有文件。
4. 自定义集成场景下手动添加插件：

   import { SourceEditing } from '@ckeditor/ckeditor5-source-editing';
   
   DecoupledEditor
       .create( document.querySelector( '#editor' ), {
           plugins: [ SourceEditing, /* 其他已用插件 */ ],
           toolbar: [ 'sourceEditing', /* 其他工具栏项 */ ]
       } )
   

额外排查 #

• 检查浏览器控制台是否有插件加载失败的报错（如404、引用错误），这能直接确认是否缺少对应插件文件。
• 确保构建版本与原项目使用的41.3.1一致，避免版本兼容问题。

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