温馨提示×

debian swagger怎么汉化

小樊
47
2026-10-25 06:32:27
栏目: 智能运维

在 Debian 上“汉化 Swagger”通常分两种情况,下面分别说明:


一、Swagger UI 页面汉化(前端界面中文)

方法 1:使用官方 i18n(推荐,Swagger UI ≥ 3.0)

Swagger UI 自带中文语言包。

1. 安装 Swagger UI(以 npm 为例)

sudo apt update
sudo apt install nodejs npm -y
npm install swagger-ui-dist

2. 修改 index.html

找到 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>

路径根据实际安装位置调整


方法 2:手动覆盖文案(通用)

编辑 swagger-ui 的 JS,搜索英文文案并替换为中文,例如:

"Try it out" → "调试"
"Execute" → "执行"
"Parameters" → "参数"

二、Swagger 注解中的中文(后端接口说明)

Spring Boot 项目示例

@Api(tags = "用户管理")
@RestController
@RequestMapping("/user")
public class UserController {

    @ApiOperation("获取用户列表")
    @GetMapping("/list")
    public List<User> list() {
        return userService.list();
    }
}

访问 Swagger UI 时即为中文说明。


三、Debian Nginx 部署 Swagger 汉化

如果你用 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 版本,我可以给你更精确的配置。

0 踩