yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/controller/admin/user/UserController.java
@@ -14,6 +14,7 @@
import cn.iocoder.yudao.module.system.dal.dataobject.permission.RoleDO;
import cn.iocoder.yudao.module.system.dal.dataobject.user.AdminUserDO;
import cn.iocoder.yudao.module.system.enums.common.SexEnum;
import cn.iocoder.yudao.module.system.controller.admin.dept.vo.dept.DeptListReqVO;
import cn.iocoder.yudao.module.system.service.dept.DeptService;
import cn.iocoder.yudao.module.system.service.permission.PermissionService;
import cn.iocoder.yudao.module.system.service.permission.RoleService;
@@ -210,17 +211,23 @@
    }
    @GetMapping("/get-import-template")
    @Operation(summary = "获得导入用户模板")
    @Operation(summary = "获得导入用户模板", description = "部门按部门名称填写,示例取自当前系统真实部门")
    public void importTemplate(HttpServletResponse response) throws IOException {
        // 手动创建导出 demo
        // 示例取当前真实部门名称,避免使用者照抄官方 demo 导致「部门不存在」
        List<DeptDO> depts = deptService.getDeptList(new DeptListReqVO());
        String sampleDept1 = CollUtil.isNotEmpty(depts) ? depts.get(0).getName() : "请填写部门名称";
        String sampleDept2 = depts.size() > 1 ? depts.get(1).getName() : sampleDept1;
        List<UserImportExcelVO> list = Arrays.asList(
                UserImportExcelVO.builder().username("yunai").deptId(1L).email("yunai@iocoder.cn").mobile("15601691300")
                        .nickname("超级管理员").status(CommonStatusEnum.ENABLE.getStatus()).sex(SexEnum.MALE.getSex()).build(),
                UserImportExcelVO.builder().username("yuanma").deptId(2L).email("yuanma@iocoder.cn").mobile("15601701300")
                        .nickname("源码").status(CommonStatusEnum.DISABLE.getStatus()).sex(SexEnum.FEMALE.getSex()).build()
                UserImportExcelVO.builder().username("zhangsan").deptName(sampleDept1).email("zhangsan@example.com")
                        .mobile("13800000001").nickname("张三")
                        .status(CommonStatusEnum.ENABLE.getStatus()).sex(SexEnum.MALE.getSex()).build(),
                UserImportExcelVO.builder().username("lisi").deptName(sampleDept2).email("lisi@example.com")
                        .mobile("13800000002").nickname("李四")
                        .status(CommonStatusEnum.ENABLE.getStatus()).sex(SexEnum.FEMALE.getSex()).build()
        );
        // 输出
        ExcelUtils.write(response, "用户导入模板.xls", "用户列表", UserImportExcelVO.class, list);
        // 日期列按文本输出,避免显示成 Excel 序列号
        ExcelUtils.writeTemplate(response, "用户导入模板.xls", "用户列表", UserImportExcelVO.class, list);
    }
    @PostMapping("/import")
@@ -232,6 +239,7 @@
    @PreAuthorize("@ss.hasPermission('system:user:import')")
    public CommonResult<UserImportRespVO> importExcel(@RequestParam("file") MultipartFile file,
                                                      @RequestParam(value = "updateSupport", required = false, defaultValue = "false") Boolean updateSupport) throws Exception {
        // 空文件 / 坏文件 / 模板不匹配等,ExcelUtils.read 已统一转换为可读的中文提示
        List<UserImportExcelVO> list = ExcelUtils.read(file, UserImportExcelVO.class);
        return success(userService.importUserList(list, updateSupport));
    }