在 Debian 上“汉化 Swagger”通常分两种情况,下面分别说明:
Swagger UI 自带中文语言包。
sudo apt update
sudo apt install nodejs npm -y
npm install swagger-ui-dist
找到 swagger-ui-dist/index.html,修改初始化代码:
<script>
window.onload = function () {
const ui = SwaggerUIBundle({
url: "https://petstore.swagger.io/v2/swagger.json",
dom_id: '#swagger-ui',
presets: [
SwaggerUIBundle.presets.apis
],
layout: "BaseLayout",
deepLinking: true
});
// 汉化
ui.specActions
window.ui = ui;
};
</script>
在页面中引入中文语言包:
<script src="./swagger-ui-dist/lang/translator.js"></script>
<script src="./swagger-ui-dist/lang/zh-cn.js"></script>
路径根据实际安装位置调整
编辑 swagger-ui 的 JS,搜索英文文案并替换为中文,例如:
"Try it out" → "调试"
"Execute" → "执行"
"Parameters" → "参数"
@Api(tags = "用户管理")
@RestController
@RequestMapping("/user")
public class UserController {
@ApiOperation("获取用户列表")
@GetMapping("/list")
public List<User> list() {
return userService.list();
}
}
访问 Swagger UI 时即为中文说明。
如果你用 Nginx 托管:
sudo apt install nginx
sudo cp -r swagger-ui-dist /var/www/html/swagger
编辑:
/var/www/html/swagger/index.html
加入中文语言包引用即可。
| 需求 | 做法 |
|---|---|
| 界面按钮中文 | 引入 zh-cn.js |
| 接口说明中文 | 后端注解写中文 |
| Debian 部署 | Nginx + swagger-ui-dist |
如果你能说明 具体技术栈(Spring / Node / Python) 和 Swagger 版本,我可以给你更精确的配置。