使用mkdocs-material主题时，mkdocs build生成的代码片段无法复制怎么办？
2026-7-23
解决mkdocs-material构建静态文件后代码片段无复制按钮的问题
出现这个问题的核心原因是生产构建模式下需要明确启用代码复制功能的配置，而开发服务（mkdocs serve）会默认启用部分便利特性。按以下步骤解决：
- 打开项目根目录的
mkdocs.yml配置文件 - 在
theme配置段中，将content.code.copy添加到features列表里，示例配置如下：
theme: name: material features: - content.code.copy # 保留你原本启用的其他特性，比如navigation.tabs等
- 保存配置后，重新执行
mkdocs build生成静态文件，此时代码片段就会显示复制按钮
如果配置后仍不生效，建议检查你的mkdocs-material版本：
- 执行
pip show mkdocs-material查看版本，若版本较旧（比如v8.x及以下），content.code.copy特性的名称为code.copy，修改配置后再重新构建 - 或者直接升级到最新版本：
pip install --upgrade mkdocs-material
内容的提问来源于stack exchange，提问作者Macondo
相关产品推荐
相关产品推荐
