AI辅助编码（前端）

本文展示一个完整的开发示例：实现图书的增删改查功能（前端）

编写枚举

编写枚举，用于前端数据字典。提示词：

• 根据实际需求，替换【】中内容

参考例子，将下面Python枚举，改写为TS对象

###
Python枚举：
【
class BookCategoryEnum(Enum):
    """图书分类枚举"""

    HISTORY = 1  # 历史
    ECONOMY = 2  # 经济
    CHILDREN = 3  # 儿童
】
    
###
参考例子：
// 菜单的类型枚举
export const SystemMenuTypeEnum = {
  DIR: 1, // 目录
  MENU: 2, // 菜单
  BUTTON: 3 // 按钮
}

• 整理输出结果，放到文件：src\utils\constants.ts。示例

// ========== DEMO 模块 ==========
//  图书分类枚举
export const BookCategoryEnum = {
  HISTORY: 1, // 历史
  ECONOMY: 2, // 经济
  CHILDREN: 3 // 儿童
}

编写Axios API接口

提示词

• 其中，提供的VO字段使用驼峰命名。例如publish_date对应publishDate

这是一个Django+DRF+Vue3的项目。根据下面信息，参考例子，编写Axios API接口
- 如果遇到枚举，使用number代替即可
- VO字段：【 id title author publisher publishDate category totalCopies price createTime 】
    
###
模型定义：
【
class BookCategoryEnum(Enum):
    """图书分类枚举"""

    HISTORY = 1  # 历史
    ECONOMY = 2  # 经济
    CHILDREN = 3  # 儿童

class DemoBook(BaseModel):
    id = models.BigAutoField(primary_key=True, db_comment="图书ID", help_text="图书ID")
    title = models.CharField(
        max_length=255,
        db_comment="书名",
        help_text="书名",
    )
    author = models.CharField(
        max_length=100,
        db_comment="作者",
        help_text="作者",
    )
    publisher = models.CharField(
        max_length=100,
        db_comment="出版社",
        help_text="出版社",
    )
    publish_date = models.DateTimeField(
        db_comment="出版日期",
        help_text="出版日期",
    )
    category = models.SmallIntegerField(
        choices=[(item.value, item.name) for item in BookCategoryEnum],
        db_comment="图书分类",
        help_text="图书分类",
    )
    total_copies = models.IntegerField(
        db_comment="总册数",
        help_text="总册数",
    )
    price = models.DecimalField(
        max_digits=10,
        decimal_places=2,
        db_comment="单价",
        help_text="单价（2位小数）",
    )
    class Meta:
        managed = True
        db_table = "demo_book"
        db_table_comment = "图书信息表"
        ordering = ["-id"]
】
        
###
参考例子：
import request from '@/config/axios'

export interface PostVO {
  id?: number
  name: string
  code: string
  sort: number
  status: number
  remark: string
  createTime?: Date
}

// 查询列表
export const getPostPage = async (params: PageParam) => {
  return await request.get({ url: '/system/post', params })
}

// 查询详情
export const getPost = async (id: number) => {
  return await request.get({ url: `/system/post/${id}` })
}

// 新增
export const createPost = async (data: PostVO) => {
  return await request.post({ url: '/system/post', data })
}

// 修改
export const updatePost = async (data: PostVO) => {
  return await request.put({ url: `/system/post/${data.id}`, data })
}

// 删除
export const deletePost = async (id: number) => {
  return await request.delete({ url: `/system/post/${id}` })
}

// 导出
export const exportPost = async (params) => {
  return await request.download({ url: '/system/post/export', params })
}

编写表单界面

提示词：

这是一个Django+DRF+Vue3的项目。根据下面信息，参考例子，编写用于新增和修改的表单界面

### 
【
文件 src\utils\constants.ts 中已定义：
//  图书分类枚举
export const BookCategoryEnum = {
  HISTORY: 1, // 历史
  ECONOMY: 2, // 经济
  CHILDREN: 3 // 儿童
}
】

### 
【
文件 src\api\demo\book\index.ts 中已定义：
export interface BookVO {
  id?: number
  title: string
  author: string
  publisher: string
  publishDate: Date
  category: number // 1-历史, 2-经济, 3-儿童
  totalCopies: number
  price: number
  createTime?: Date
}
// 查询图书列表
export const getBookPage = async (params: PageParam) => {
  return await request.get({ url: '/demo/book', params })
}
// 查询图书详情
export const getBook = async (id: number) => {
  return await request.get({ url: `/demo/book/${id}` })
}
// 新增图书
export const createBook = async (data: BookVO) => {
  return await request.post({ url: '/demo/book', data })
}
// 修改图书
export const updateBook = async (data: BookVO) => {
  return await request.put({ url: `/demo/book/${data.id}`, data })
}
// 删除图书
export const deleteBook = async (id: number) => {
  return await request.delete({ url: `/demo/book/${id}` })
}
// 导出图书
export const exportBook = async (params) => {
  return await request.download({ url: '/demo/book/export', params })
}
】

###
参考例子：
<template>
  <Dialog v-model="dialogVisible" :title="dialogTitle" width="800">
    <el-form
      ref="formRef"
      v-loading="formLoading"
      :model="formData"
      :rules="formRules"
      label-width="80px"
    >
      <el-form-item label="岗位名称" prop="name">
        <el-input v-model="formData.name" placeholder="请输入岗位标题" />
      </el-form-item>
      <el-form-item label="岗位编码" prop="code">
        <el-input v-model="formData.code" placeholder="请输入岗位编码" />
      </el-form-item>
      <el-form-item label="岗位顺序" prop="sort">
        <el-input v-model="formData.sort" placeholder="请输入岗位顺序" />
      </el-form-item>
      <el-form-item label="状态" prop="status">
        <el-select v-model="formData.status" clearable placeholder="请选择状态">
          <el-option
            v-for="dict in getIntDictOptions(DICT_TYPE.COMMON_STATUS)"
            :key="dict.value"
            :label="dict.label"
            :value="dict.value"
          />
        </el-select>
      </el-form-item>
      <el-form-item label="备注" prop="remark">
        <el-input v-model="formData.remark" placeholder="请输备注" type="textarea" />
      </el-form-item>
    </el-form>
    <template #footer>
      <el-button :disabled="formLoading" type="primary" @click="submitForm">确 定</el-button>
      <el-button @click="dialogVisible = false">取 消</el-button>
    </template>
  </Dialog>
</template>
<script lang="ts" setup>
import { DICT_TYPE, getIntDictOptions } from '@/utils/dict'
import { CommonStatusEnum } from '@/utils/constants'
import * as PostApi from '@/api/system/post'

defineOptions({ name: 'SystemPostForm' })

const { t } = useI18n() // 国际化
const message = useMessage() // 消息弹窗

const dialogVisible = ref(false) // 弹窗的是否展示
const dialogTitle = ref('') // 弹窗的标题
const formLoading = ref(false) // 表单的加载中：1）修改时的数据加载；2）提交的按钮禁用
const formType = ref('') // 表单的类型：create - 新增；update - 修改
const formData = ref({
  id: undefined,
  name: '',
  code: '',
  sort: 0,
  status: CommonStatusEnum.ENABLE,
  remark: ''
})
const formRules = reactive({
  name: [{ required: true, message: '岗位名称不能为空', trigger: 'blur' }],
  code: [{ required: true, message: '岗位编码不能为空', trigger: 'change' }],
  status: [{ required: true, message: '岗位状态不能为空', trigger: 'change' }],
  sort: [{ required: true, message: '岗位顺序不能为空', trigger: 'blur' }]
})
const formRef = ref() // 表单 Ref

/** 打开弹窗 */
const open = async (type: string, id?: number) => {
  dialogVisible.value = true
  dialogTitle.value = t('action.' + type)
  formType.value = type
  resetForm()
  // 修改时，设置数据
  if (id) {
    formLoading.value = true
    try {
      formData.value = await PostApi.getPost(id)
    } finally {
      formLoading.value = false
    }
  }
}
defineExpose({ open }) // 提供 open 方法，用于打开弹窗

/** 提交表单 */
const emit = defineEmits(['success']) // 定义 success 事件，用于操作成功后的回调
const submitForm = async () => {
  // 校验表单
  if (!formRef) return
  const valid = await formRef.value.validate()
  if (!valid) return
  // 提交请求
  formLoading.value = true
  try {
    const data = formData.value as unknown as PostApi.PostVO
    if (formType.value === 'create') {
      await PostApi.createPost(data)
      message.success(t('common.createSuccess'))
    } else {
      await PostApi.updatePost(data)
      message.success(t('common.updateSuccess'))
    }
    dialogVisible.value = false
    // 发送操作成功的事件
    emit('success')
  } finally {
    formLoading.value = false
  }
}

/** 重置表单 */
const resetForm = () => {
  formData.value = {
    id: undefined,
    name: '',
    code: '',
    sort: undefined,
    status: CommonStatusEnum.ENABLE,
    remark: ''
  } as any
  formRef.value?.resetFields()
}
</script>

整理输出结果，如果报错或飘红，参考本文最后一节的错误处理方法。

编写主界面

提示词

这是一个Django+DRF+Vue3的项目。根据下面信息，参考例子，编写Vue页面
- 搜索栏字段： 【 title author publish_date category 】
- 列表展示字段： 【 id title author publisher publish_date category total_copies price 】
- 表单弹窗（添加/修改）组件名称为： 【 BookForm 】
    

### 
【
文件 src\utils\constants.ts 中已定义：
//  图书分类枚举
export const BookCategoryEnum = {
  HISTORY: 1, // 历史
  ECONOMY: 2, // 经济
  CHILDREN: 3 // 儿童
}
】

### 
【
文件 src\api\demo\book\index.ts 中已定义：
export interface BookVO {
  id?: number
  title: string
  author: string
  publisher: string
  publishDate: Date
  category: number // 1-历史, 2-经济, 3-儿童
  totalCopies: number
  price: number
  createTime?: Date
}
// 查询图书列表
export const getBookPage = async (params: PageParam) => {
  return await request.get({ url: '/demo/book', params })
}
// 查询图书详情
export const getBook = async (id: number) => {
  return await request.get({ url: `/demo/book/${id}` })
}
// 新增图书
export const createBook = async (data: BookVO) => {
  return await request.post({ url: '/demo/book', data })
}
// 修改图书
export const updateBook = async (data: BookVO) => {
  return await request.put({ url: `/demo/book/${data.id}`, data })
}
// 删除图书
export const deleteBook = async (id: number) => {
  return await request.delete({ url: `/demo/book/${id}` })
}
// 导出图书
export const exportBook = async (params) => {
  return await request.download({ url: '/demo/book/export', params })
}
】

###
模型定义：
【
class BookCategoryEnum(Enum):
    """图书分类枚举"""

    HISTORY = 1  # 历史
    ECONOMY = 2  # 经济
    CHILDREN = 3  # 儿童

class DemoBook(BaseModel):
    id = models.BigAutoField(primary_key=True, db_comment="图书ID", help_text="图书ID")
    title = models.CharField(
        max_length=255,
        db_comment="书名",
        help_text="书名",
    )
    author = models.CharField(
        max_length=100,
        db_comment="作者",
        help_text="作者",
    )
    publisher = models.CharField(
        max_length=100,
        db_comment="出版社",
        help_text="出版社",
    )
    publish_date = models.DateTimeField(
        db_comment="出版日期",
        help_text="出版日期",
    )
    category = models.SmallIntegerField(
        choices=[(item.value, item.name) for item in BookCategoryEnum],
        db_comment="图书分类",
        help_text="图书分类",
    )
    total_copies = models.IntegerField(
        db_comment="总册数",
        help_text="总册数",
    )
    price = models.DecimalField(
        max_digits=10,
        decimal_places=2,
        db_comment="单价",
        help_text="单价（2位小数）",
    )
    class Meta:
        managed = True
        db_table = "demo_book"
        db_table_comment = "图书信息表"
        ordering = ["-id"]
】

###
参考例子：
<template>
  <ContentWrap>
    <!-- 搜索栏 -->
    <el-form
      class="-mb-15px"
      :model="queryParams"
      ref="queryFormRef"
      :inline="true"
      label-width="68px"
    >
      <el-form-item label="岗位名称" prop="name">
        <el-input
          v-model="queryParams.name"
          placeholder="请输入岗位名称"
          clearable
          class="!w-240px"
          @keyup.enter="handleQuery"
        />
      </el-form-item>
      <el-form-item label="岗位编码" prop="code">
        <el-input
          v-model="queryParams.code"
          placeholder="请输入岗位编码"
          clearable
          class="!w-240px"
          @keyup.enter="handleQuery"
        />
      </el-form-item>
      <el-form-item label="状态" prop="status">
        <el-select v-model="queryParams.status" placeholder="请选择状态" clearable class="!w-240px">
          <el-option
            v-for="dict in getIntDictOptions(DICT_TYPE.COMMON_STATUS)"
            :key="dict.value"
            :label="dict.label"
            :value="dict.value"
          />
        </el-select>
      </el-form-item>
      <el-form-item>
        <el-button @click="handleQuery"><Icon icon="ep:search" class="mr-5px" /> 搜索</el-button>
        <el-button @click="resetQuery"><Icon icon="ep:refresh" class="mr-5px" /> 重置</el-button>
        <el-button
          type="primary"
          plain
          @click="openForm('create')"
          v-hasPermi="['system:post:create']"
        >
          <Icon icon="ep:plus" class="mr-5px" /> 新增
        </el-button>
        <el-button
          type="success"
          plain
          @click="handleExport"
          :loading="exportLoading"
          v-hasPermi="['system:post:export']"
        >
          <Icon icon="ep:download" class="mr-5px" /> 导出
        </el-button>
      </el-form-item>
    </el-form>
  </ContentWrap>

  <!-- 列表展示 -->
  <ContentWrap>
    <el-table v-loading="loading" :data="list">
      <el-table-column label="岗位编号" align="center" prop="id" />
      <el-table-column label="岗位名称" align="center" prop="name" />
      <el-table-column label="岗位编码" align="center" prop="code" />
      <el-table-column label="岗位顺序" align="center" prop="sort" />
      <el-table-column label="岗位备注" align="center" prop="remark" />
      <el-table-column label="状态" align="center" prop="status">
        <template #default="scope">
          <dict-tag :type="DICT_TYPE.COMMON_STATUS" :value="scope.row.status" />
        </template>
      </el-table-column>
      <el-table-column
        label="创建时间"
        align="center"
        prop="createTime"
        width="180"
        :formatter="dateFormatter"
      />
      <el-table-column label="操作" align="center">
        <template #default="scope">
          <el-button
            link
            type="primary"
            @click="openForm('update', scope.row.id)"
            v-hasPermi="['system:post:update']"
          >
            编辑
          </el-button>
          <el-button
            link
            type="danger"
            @click="handleDelete(scope.row.id)"
            v-hasPermi="['system:post:delete']"
          >
            删除
          </el-button>
        </template>
      </el-table-column>
    </el-table>
    <!-- 分页 -->
    <Pagination
      :total="total"
      v-model:page="queryParams.pageNo"
      v-model:limit="queryParams.pageSize"
      @pagination="getList"
    />
  </ContentWrap>

  <!-- 表单弹窗（添加/修改） -->
  <PostForm ref="formRef" @success="getList" />
</template>
<script lang="ts" setup>
import { DICT_TYPE, getIntDictOptions } from '@/utils/dict'
import { dateFormatter } from '@/utils/formatTime'
import download from '@/utils/download'
import * as PostApi from '@/api/system/post'
import PostForm from './PostForm.vue'

defineOptions({ name: 'SystemPost' })

const message = useMessage() // 消息弹窗
const { t } = useI18n() // 国际化

const loading = ref(true) // 列表的加载中
const total = ref(0) // 列表的总页数
const list = ref([]) // 列表的数据
const queryParams = reactive({
  pageNo: 1,
  pageSize: 10,
  code: '',
  name: '',
  status: undefined
})
const queryFormRef = ref() // 搜索的表单
const exportLoading = ref(false) // 导出的加载中

/** 查询岗位列表 */
const getList = async () => {
  loading.value = true
  try {
    const data = await PostApi.getPostPage(queryParams)
    list.value = data.list
    total.value = data.total
  } finally {
    loading.value = false
  }
}

/** 搜索按钮操作 */
const handleQuery = () => {
  queryParams.pageNo = 1
  getList()
}

/** 重置按钮操作 */
const resetQuery = () => {
  queryFormRef.value.resetFields()
  handleQuery()
}

/** 添加/修改操作 */
const formRef = ref()
const openForm = (type: string, id?: number) => {
  formRef.value.open(type, id)
}

/** 删除按钮操作 */
const handleDelete = async (id: number) => {
  try {
    // 删除的二次确认
    await message.delConfirm()
    // 发起删除
    await PostApi.deletePost(id)
    message.success(t('common.delSuccess'))
    // 刷新列表
    await getList()
  } catch {}
}

/** 导出按钮操作 */
const handleExport = async () => {
  try {
    // 导出的二次确认
    await message.exportConfirm()
    // 发起导出
    exportLoading.value = true
    const data = await PostApi.exportPost(queryParams)
    download.excel(data, '岗位列表.xlsx')
  } catch {
  } finally {
    exportLoading.value = false
  }
}

/** 初始化 **/
onMounted(() => {
  getList()
})
</script>

整理输出结果，如果报错或飘红，参考本文最后一节的错误处理方法。

错误处理

整理输出结果，如果报错或飘红，处理方法：

• 方法一：对比输出结果与参考例子，找出明显差异/错误的地方，手动调整
• 方法二：VSCode安装 通义灵码 插件（或其它AI编码工具），问题——右击——选择“通义灵码一键修复”

• 方法三：重启VSCode，如果问题依旧，重复上面方法。