laravel api文档中文支持需配置scribe的title、description及default_language，注释用中文并汉化视图，通过@group/@subgroup和phpdoc添加中文标题说明，确保环境utf-8编码。
为 Laravel API 文档添加中文支持并自定义标题，核心在于两件事：一是让文档生成工具识别并输出中文内容，二是控制文档整体呈现的语义与风格。Scribe 是当前 Laravel 生态中最主流、维护活跃、中文适配友好的选择，以下操作均基于 knuckleswtf/scribe（v4+）展开。
配置 Scribe 支持中文文档输出
Scribe 本身不强制绑定语言，但默认模板和注释解析是中立的。要让最终 HTML 文档显示中文标题、描述、按钮文字等，需从三处入手：
- 在
config/scribe.php中设置'title' => '我的API接口文档（中文版）'和'description' => '本项目后端接口说明，含请求参数、响应格式与认证方式。' - 将
'default_language' => 'zh'加入配置（虽非必需，但可作为代码示例语言的默认值） - 确保控制器注释本身用中文书写，例如：
@group 用户管理、@bodyParam phone string required 手机号，11位数字—— Scribe 直接提取这些文本，无需额外翻译层
替换或扩展默认视图以支持中文 UI 元素
默认生成的 HTML 页面中，“Try it out”、“Send request”、“Response body” 等按钮和标签仍是英文。要彻底汉化，需发布并修改视图：
- 运行
php artisan vendor:publish --tag=scribe-views，将默认 Blade 模板复制到resources/views/vendor/scribe - 编辑
resources/views/vendor/scribe/index.blade.php，搜索英文字符串并替换成中文，如{{ __('Try it out') }}→调试接口（注意：Scribe 默认未启用 Laravel 的翻译函数，直接写中文更稳妥） - 若希望保留多语言能力，可自行引入
__('xxx')并在resources/lang/zh/scribe.php中定义键值对，但需同步在config/scribe.php中启用'use_laravel_translations' => true
为每个接口组和接口添加中文标题与说明
中文标题不是靠全局配置一劳永逸的，而是通过注解逐层细化：
- 用
@group 用户管理给整个控制器或方法分组，该文字会成为左侧导航栏一级标题 - 用
@subgroup 登录与认证进一步细分，生成二级折叠菜单 - 控制器方法上方的 PHPDoc 短描述（即
/** 获取用户列表 */中的“获取用户列表”）会作为接口卡片主标题显示 - 长描述（PHPDoc 中的正文段落）会渲染为接口详情页顶部说明，建议用完整中文句式，如：“返回所有已激活用户的分页列表，支持按昵称模糊搜索。”
确保生成命令输出稳定且含中文字符
避免终端乱码或 HTML 中文显示异常，需确认环境基础支持：
- 执行
php artisan scribe:generate前，确保系统 locale 支持 UTF-8（Linux/macOS 可检查locale命令输出；Windows 建议使用 WSL 或 Git Bash） - 若使用 CI/CD 自动构建文档，需在脚本中显式设置环境变量，例如：
export LANG=zh_CN.UTF-8 - 生成后的
public/docs/index.html应包含<meta charset="UTF-8">，Scribe 默认已写入，无需手动添加
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
