本文探讨了从 Rap 迁移至 ShowDoc 的接口文档编写设计，分析了两者在 JSON 导入功能及参数层级展示上的差异。鉴于 ShowDoc 默认模板仅支持一级参数且无 JSON 导入功能，文章排除了京东文档中高难度的合并单元格方案，转而定制了支持多级参数的互动运营 API 接口模板，最终验证其显示效果符合预期，解决了多级参数的展示需求。
在 Rap 工具的使用中发现某接口文档的字号显示异常小于其他文档。经排查分析，定位原因为数据结构定义中的 object 标记丢失，随后决定将数据类型描述由 array 修改为 array。修改操作完成后，文档字号显示恢复正常，符合预期效果，成功解决了字号不一致的问题。
👨💻 个人品牌
王世强｜PHP / Go 技术顾问
15+ 年 Web 后端开发经验，专注于系统维护、架构优化、性能调优及 Linux 运维。
持续运营技术博客 10+ 年，累计发布 1000+ 篇原创技术文章。
为创业团队、中小企业及独立开发者提供长期技术支持与远程合作服务。
.env (14) add (16) AI 翻译 (30) Apache (13) Array (19) A Tour of Go (67) Cache (13) CentOS (23) ChatGPT (20) ChatGPT Plus (15) chrome (19) Cloudflare (33) Codex (22) composer (42) composer.json (22) composer install (13) composer update (14) console (16) Container (25) curl (16) delete (31) Docker (32) Dockerfile (15) EdgeOne (33) environment variable (19) error (24) file (15) filter (20) Git (27) GitHub (23) Gitlab (15) GLM-5.2 (26) Go (61) go-tour-i18n (14) Google AdSense (29) Go 语言 (24) GraphQL (24) GraphQL API (14) Gutenberg (34) http (21) https (22) Interface (19) Jquery (13) json (24) Laravel (37) Laravel 6 (55) Laravel 9 (25) Lighthouse (17) Lighthouse 5 (14) Linux (22) Migrate (13) Module (17) MySQL (78) MySQL 5.7 (22) Nginx (63) normalize.css (28) OKX (15) OneinStack (21) PHP (67) php-fpm (19) php.ini (24) PHP 7.1.12 (22) PHP 7.4 (26) phpmyadmin (15) PhpStorm (24) Polylang (57) postman (18) Query (17) queue (16) Rancher (24) Redis (50) response (13) RESTful (27) RESTful API (23) Shopify (19) SlyTranslate (20) SQL (24) String (14) TortoiseGit (14) Twenty Twenty-Five (20) Ubuntu (40) update (20) VPN (17) W3 Total Cache (37) Windows 10 (46) WireGuard (28) WordPress (131) WordPress 多语言 (13) WPCode (23) Wstunnel (15) Yii (40) Yii 2 (70) Yii 2.0 (51) ZgoCloud (13) 多语言翻译 (35) 技术博客 (15) 故障排查 (15) 数据库迁移 (16) 浏览器 (14) 阿里云 (19)
