企业官网建设流程全解析

这两年，打开IDEA写Java，AI写代码已经不是什么新鲜事。我自己日常开发里，灵码插件是停留时间最长的一个，尤其碰上学生管理系统这种绕不开的 CRUD 课设项目，与其从头手敲，不如先让灵码出一版，再照着业务需求改，整体效率完全是两个档次。

这篇文章不聊虚的，就拿一个最典型的“学生管理系统”当例子，把 IDEA 里装灵码、登录、然后一步步用它生成项目骨架、实体类、Mapper、Service、Controller、页面和 SQL 的全流程拆给你看。里面给的提示词和代码片段，基本都能直接复制到自己项目里试。适合刚接触 AI 辅助开发的 Java 入门者，也适合带学生做课设、想省点重复工作量的老师。

我的建议是把这篇当成一张操作地图：先跟着第一章把插件装好，再照着第三章把系统跑起来，然后回看第四章的提问技巧和第五章的坑。顺序不用乱，照着走，一下午能跑通。

1. 为什么选灵码插件：准备工作做扎实

1.1 灵码到底能替你干什么

很多刚接触 AI 编程的人，以为灵码就是“自动补全”，其实它远不止这个。放在 IDEA 里，它起码能干这么几件事：

我用它最频繁的场景其实是“帮我把废话变成代码”。比如需要写一个分页查询，以前我得手写 PageHelper 的分页插件配置，再写 PageResult、再写 Mapper 里的 limit，现在一句话扔给灵码，它能把能跑的骨架给你铺好，我只需要改里面的业务字段。

之所以选它而不是别家插件，核心原因是中文理解好。我给它描述“学生按班级查，分页，每页十条，返回总条数”，它能准确转化成 Mapper 参数和页面表格。换英文描述有时候会因为语义偏差来回调好几次。另外，个人版免费额度对课设和日常开发完全够用，IDEA 社区版也能装，不用折腾别的。

1.2 版本与环境的准备工作

灵码插件对 IDEA 版本有门槛，太老的版本在插件市场里搜不到。我踩过一次，2020.1 的 IDEA 装到一半就提示版本不兼容，白白浪费了下载时间。建议项目开始前先确认三件事：

• IDEA 版本 2020.3 以上，推荐 2023.3 或 2024 系列，社区版和旗舰版都可以。
• 本机装有 JDK，学生管理系统示例我用的 JDK 17，配 Spring Boot 3。如果电脑上只有 JDK 8，那建议把 Spring Boot 版本降到 2.7.x，灵码对这两个版本都认识。
• 装了 Maven 和 MySQL，MySQL 5.7 或 8.0 都行，注意 8.0 的驱动名是com.mysql.cj.jdbc.Driver。

另外说句实在话，整个流程不需要任何破解或者激活码。IDEA 社区版免费，灵码个人版也免费，跑通这套学生管理系统绰绰有余。学习阶段别把精力浪费在折腾授权上，能把项目跑起来比啥都强。

1.3 安装灵码插件的两种方法

在线安装是最常规的路子，操作步骤给你列清楚：

1. 打开 IDEA，Windows 下进入File → Settings，Mac 下是IDEA → Preferences。
2. 左侧找到Plugins，切到Marketplace标签。
3. 搜索框里搜“通义灵码”或者英文TONGYI Lingma。
4. 找到插件后点Install，等进度条走完，点Restart IDE重启。
5. 重启后右侧会出现灵码面板，点“立即登录”。
6. 用手机上的阿里云 App 扫码，或者收短信验证码登录，淘宝、钉钉账号也能登录。
7. 登录成功后回到编辑器，随便写一行 Java 代码，会自动出现灰色补全提示，说明插件已经生效。

如果插件市场搜不到，多半是网络限制或者 IDEA 版本太旧。真遇到这种情况，去灵码官网把插件安装包（zip 格式）下载回来，然后在Plugins设置页点右上角的齿轮，选Install Plugin from Disk，选中刚下载的 zip 包，重启就装上了。这个离线安装方法我帮同事弄过好多次，是搜索不到时最靠谱的兜底方案。

2. 学生管理系统，先想清楚再让 AI 动手

2.1 功能边界与技术栈，AI 替不了你做决定

很多人一上来就让灵码“生成一个学生管理系统”，结果它只能吐出一堆零散的实体类，连业务逻辑都串不起来。原因很简单，需求太模糊，AI 不知道要考虑哪些功能、哪些角色。

我在给学生做课设指导的时候，一定要先把功能边界定下来。拿学生管理系统来说，最低限度也要包含这几块：

• 登录功能：教师或管理员登录后进入管理页。
• 学生信息管理：学生列表、新增、编辑、删除、按姓名或学号搜索。
• 班级维度统计：各班级人数、男女生人数、年龄段分布。
• 课程与成绩的基础管理：课程列表、按学生录入成绩。

技术栈的选择也要提前定。我这里用的是Spring Boot 3 + Thymeleaf + MyBatis + MySQL，理由很现实：代码量适中，课设答辩时容易讲清楚，而且这个组合的数据在灵码训练语料里特别多，生成质量明显高。如果你想做前后端分离，也可以让灵码生成 Vue 页面和 Controller 返回 JSON，但那一套链路更长，本篇先用“服务端渲染页面”的方式，保证一个项目一个仓库能完整跑起来。

2.2 让灵码把需求翻译成第一版代码

把需求和约束定清楚之后，就可以让灵码干活了。我习惯分两步走：先用 IDEA 自带的 Spring Initializr 把项目骨架建出来，再让灵码往骨架里填充业务代码。这样比让它一口气生成整个项目更可控，因为项目主类、pom.xml 的基础结构由 IDEA 生成是最稳的，不容易因为版本问题跑不起来。

骨架建好后，给灵码发这样的提示词：

我现在有一个Spring Boot 3项目，引入了web、thymeleaf、mybatis、mysql依赖。 需要做一个学生管理系统，包含学生的增删改查。 学生表结构是：id、student_no、name、gender、age、class_name、phone、create_time。 请帮我生成对应的Student实体类、StudentMapper接口和Mapper XML。

这个提示词把“技术栈、业务、表结构”全说清楚了，灵码一般能给你一套完整的三个文件。如果它只吐了部分代码，你就追加一句“继续，剩余代码也一起给我”，它就会继续补。AI 模型对“多轮对话”的理解很好，别指望一次问完所有东西，拆成小步骤问，得到的代码质量更高。

2.3 六个好用提示词模板，可以直接复制

用久了你会发现，灵码写代码的质量，七成取决于提问方式。下面这几个模板是我日常高频使用的，直接复制改一改就能用：

1. 生成实体：

生成学生实体类Student，字段有id、studentNo、name、gender、age、className、phone、createTime， 使用Lombok的@Data注解，字段类型与数据库列一一对应。

2. 生成 Mapper 接口：

在StudentMapper接口中补充学生增删改查方法，使用MyBatis注解SQL， 包括findAll、findById、insert、update、deleteById。

3. 生成 Service 层：

创建StudentService接口和StudentServiceImpl实现类， 通过StudentMapper完成学生列表查询和新增、修改、删除， 列表查询要求按姓名模糊搜索，返回List<Student>。

4. 生成 Controller：

创建StudentController，包含学生列表、新增、编辑、删除的路由。 页面跳转使用@Controller，列表数据放入Model，新增和修改使用POST提交，删除使用GET跳转。

5. 生成 SQL：

根据学生表student（id、student_no、name、gender、age、class_name、phone、create_time）建表， 并插入8条测试数据，create_time用当前时间。

6. 修复代码：

下面这段代码编译报错：错误信息是xxx。 请指出问题原因，并给出修改后的完整类。

这些模板最大的价值是“把约束写进去”。比如要求“列表查询按姓名模糊搜索”，它就会自动给你拼LIKE '%${name}%'，你只需要盯着它的 SQL 改成#{name}防止注入即可，比让它自由发挥再改半天要省力得多。

3. 实操：从空项目到能跑的学生管理系统

3.1 第一步：用 IDEA 初始化 Spring Boot 项目

打开 IDEA，New Project → Spring Initializr，选 JDK 17，Java 版本选 17。依赖这里可以勾上Spring Web、Thymeleaf、MyBatis Framework、MySQL Driver。IDEA 帮你生成一个标准的 Maven 项目，里面已经带好了Application启动类，这是最省事的路径。

如果你用的 IDEA 版本没有 Spring Initializr，那就直接让灵码生成 pom.xml，我实测它生成的依赖基本没跑偏过。核心依赖如下：

<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>3.2.4</version> <relativePath/> </parent> <properties> <java.version>17</java.version> </properties> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>3.0.3</version> </dependency> <dependency> <groupId>com.mysql</groupId> <artifactId>mysql-connector-j</artifactId> <scope>runtime</scope> </dependency> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency> </dependencies>

我之前遇到一个坑，就是 MyBatis starter 版本和 Spring Boot 版本对不上。Spring Boot 2.x 要用mybatis-spring-boot-starter的 2.x 版本，Spring Boot 3.x 必须用 3.x 版本，否则启动时会直接报一堆 ClassNotFound。灵码对版本兼容性有时候意识不到，所以建项目时优先让 IDEA 帮选依赖，别完全放手给 AI。

3.2 第二步：让灵码生成实体、Mapper 与 XML

项目建好后，在src/main/java下建好包名，比如com.example.studentms.entity、com.example.studentms.mapper、com.example.studentms.service、com.example.studentms.controller。包结构建清楚，后面灵码生成代码时才知道往哪放。

接下来把提示词发给灵码，让它生成 Student 实体类。正常它会给你类似这样的代码：

package com.example.studentms.entity; import lombok.Data; import java.time.LocalDateTime; @Data public class Student { private Integer id; private String studentNo; private String name; private String gender; private Integer age; private String className; private String phone; private LocalDateTime createTime; }

生成 Mapper 接口时，我一般要它同时写出注解 SQL 或 XML 两种方案，防止它只给你接口不给你实现。下面是注解版：

package com.example.studentms.mapper; import com.example.studentms.entity.Student; import org.apache.ibatis.annotations.*; import java.util.List; @Mapper public interface StudentMapper { @Select("select * from student order by id desc") List<Student> findAll(); @Select("select * from student where id = #{id}") Student findById(Integer id); @Insert("insert into student(student_no, name, gender, age, class_name, phone) " + "values(#{studentNo}, #{name}, #{gender}, #{age}, #{className}, #{phone})") @Options(useGeneratedKeys = true, keyProperty = "id") int insert(Student student); @Update("update student set student_no=#{studentNo}, name=#{name}, gender=#{gender}, " + "age=#{age}, class_name=#{className}, phone=#{phone} where id=#{id}") int update(Student student); @Delete("delete from student where id = #{id}") int deleteById(Integer id); }

如果你喜欢 XML 风格，就让灵码生成一套StudentMapper.xml，放resources/mapper目录里。然后在application.yml里加一行mapper-locations: classpath:mapper/*.xml，不然 MyBatis 找不到 XML 文件。

application.yml我习惯让灵码生成，然后自己把数据源信息改成真实环境：

server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/student_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 123456 thymeleaf: cache: false mybatis: mapper-locations: classpath:mapper/*.xml configuration: map-underscore-to-camel-case: true

这里最重要的设置是map-underscore-to-camel-case: true，它负责把数据库的student_no自动映射成实体类的studentNo，不然查询结果里studentNo永远是 null，这个坑新手最容易踩。

3.3 第三步：让灵码生成 Service 与 Controller

Service 层是业务逻辑所在，灵码写出来通常是“薄薄一层壳”。让它生成接口和实现类是没问题的，逻辑简单，比手写快得多。

package com.example.studentms.service; import com.example.studentms.entity.Student; import java.util.List; public interface StudentService { List<Student> findAll(); Student findById(Integer id); void add(Student student); void update(Student student); void delete(Integer id); }

实现类记得让它加上@Service注解和@Autowired注入 Mapper，不然 Spring 容器里没这个 Bean，启动直接报错：

package com.example.studentms.service.impl; import com.example.studentms.entity.Student; import com.example.studentms.mapper.StudentMapper; import com.example.studentms.service.StudentService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import java.util.List; @Service public class StudentServiceImpl implements StudentService { @Autowired private StudentMapper studentMapper; @Override public List<Student> findAll() { return studentMapper.findAll(); } @Override public Student findById(Integer id) { return studentMapper.findById(id); } @Override public void add(Student student) { studentMapper.insert(student); } @Override public void update(Student student) { studentMapper.update(student); } @Override public void delete(Integer id) { studentMapper.deleteById(id); } }

Controller 层我给灵码的提示词是：

生成StudentController，使用@Controller注解， 包含student/list列表页、student/toAdd新增页、student/add提交新增、 student/toEdit编辑页、student/edit提交修改、student/delete删除接口。 列表数据放入Model，新增修改完成后重定向到/student/list。

它生成完，核心代码大约长这样：

package com.example.studentms.controller; import com.example.studentms.entity.Student; import com.example.studentms.service.StudentService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.*; @Controller @RequestMapping("/student") public class StudentController { @Autowired private StudentService studentService; @GetMapping("/list") public String list(Model model) { model.addAttribute("students", studentService.findAll()); return "student/list"; } @GetMapping("/toAdd") public String toAdd() { return "student/add"; } @PostMapping("/add") public String add(Student student) { studentService.add(student); return "redirect:/student/list"; } @GetMapping("/toEdit") public String toEdit(@RequestParam Integer id, Model model) { model.addAttribute("student", studentService.findById(id)); return "student/edit"; } @PostMapping("/edit") public String edit(Student student) { studentService.update(student); return "redirect:/student/list"; } @GetMapping("/delete") public String delete(@RequestParam Integer id) { studentService.delete(id); return "redirect:/student/list"; } }

这套 Controller 如果你自己手写，怎么也得十来分钟，灵码差不多半分钟就出全了。我只需要确认两个点：一是方法上的路由注解对不对，二是重定向路径跟页面按钮路径是否一致。改起来很快。

3.4 第四步：页面模板与表单校验

学生管理系统这类课设，页面是必须有的。用 Thymeleaf 的话，在src/main/resources/templates/student/下放list.html、add.html、edit.html。

列表页我让灵码生成模板，提示词是：

生成一个学生列表页面list.html，使用Thymeleaf模板， 引入Bootstrap的CDN样式，用表格展示学生数据， 每行后面有编辑和删除按钮，编辑跳转/student/toEdit?id=xx，删除跳转/student/delete?id=xx， 页面顶部有新增按钮，跳转/student/toAdd。

灵码生成的页面框架一般是能用的，但样式比较朴素。我自己经常补一段自定义 CSS，让页面在答辩时好看一点。核心的表格循环部分大概是这样：

<table class="table table-striped"> <thead> <tr> <th>学号</th> <th>姓名</th> <th>性别</th> <th>年龄</th> <th>班级</th> <th>电话</th> <th>操作</th> </tr> </thead> <tbody> <tr th:each="stu : ${students}"> <td th:text="${stu.studentNo}"></td> <td th:text="${stu.name}"></td> <td th:text="${stu.gender}"></td> <td th:text="${stu.age}"></td> <td th:text="${stu.className}"></td> <td th:text="${stu.phone}"></td> <td> <a th:href="@{/student/toEdit(id=${stu.id})}">编辑</a> <a th:href="@{/student/delete(id=${stu.id})}" onclick="return confirm('确定删除吗？')">删除</a> </td> </tr> </tbody> </table>

表单校验是很多人容易忽略的一环。让灵码生成新增页add.html时，记得追加一句“学号和姓名必填，年龄必须是0到150之间的数字”。它会在表单里帮你加required之类的属性。但真正严谨的服务端校验，你得自己在 Controller 里加，比如用 Spring Validation 的@Valid，或者最简单的if (student.getName() == null || student.getName().isEmpty())判断。这些都不能省，哪怕是课设，答辩老师也会盯着这块问。

3.5 第五步：SQL 与初始化数据

数据库脚本让灵码生成特别快。我在对话里输入“生成学生表建表语句”，它就给我下面的 SQL：

CREATE DATABASE IF NOT EXISTS student_db DEFAULT CHARACTER SET utf8mb4; USE student_db; CREATE TABLE student ( id INT AUTO_INCREMENT PRIMARY KEY, student_no VARCHAR(20) NOT NULL UNIQUE, name VARCHAR(50) NOT NULL, gender VARCHAR(10), age INT, class_name VARCHAR(50), phone VARCHAR(20), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); INSERT INTO student(student_no, name, gender, age, class_name, phone) VALUES ('2024001', '张三', '男', 20, '软工2401', '13800000001'), ('2024002', '李四', '女', 21, '软工2402', '13800000002'), ('2024003', '王五', '男', 22, '软工2401', '13800000003');

执行的时候，我用 IDEA 自带的 Database 工具连上 MySQL，右键运行整个 SQL 脚本，很顺手。如果你要提前做统计报表，还可以让灵码生成统计 SQL：

SELECT COUNT(*) AS total FROM student; SELECT class_name, COUNT(*) AS cnt FROM student GROUP BY class_name; SELECT AVG(age) AS avg_age FROM student;

把统计结果放到 Controller 的 Model 里，页面就能显示统计信息了。这一步的核心价值在于，灵码能把“按班级分组统计人数”这类查询直接转成可执行的 SQL，不用你再翻 MySQL 语法。

3.6 第六步：编译运行与联调

所有代码生成完毕，运行StudentMsApplication的 main 方法，启动日志里出现Tomcat started on port 8080，就说明项目起来了。浏览器访问http://localhost:8080/student/list，如果能看到表格数据，整套流程就走通了。

实际联调中最容易出问题的点，是请求路径对不上。比如页面里新增按钮跳的是/student/toAdd，Controller 里路由写成了/student/addPage，结果一点按钮就 404。遇到这种问题，不要自己一行一行找，直接把页面代码和 Controller 代码全部复制到灵码对话框里，问它“为什么按钮跳转后 404，帮我找出不匹配的地方”，它很快就能比对出来。

我自己的习惯是跑通基础流程后，再追加几个功能点让灵码改：加一个按姓名模糊查询的搜索框、加一个删除前的确认弹窗、加一个按班级筛选的下拉框。每加一个功能就用一次对话，积少成多，系统功能就丰富了。

4. 灵码实战技巧：让 AI 按你的思路写码

4.1 提问公式：角色、需求、技术栈、约束

想用好灵码，最核心的一件事是把提问公式记牢：角色 + 需求 + 技术栈 + 约束。

举个例子，如果你想生成一个分页查询接口，不要只写“帮我写个分页查询”，而要写：“你是一名有经验的Java工程师，请使用Spring Boot 3、MyBatis-Plus，为学生管理写一个分页查询方法，入参是pageNum、pageSize、name，返回值包含分页数据和总条数，使用R对象统一返回。”

我试过很多次，提示词里带上“角色设定”之后，生成代码的规范程度明显提升。它会天然地考虑异常处理和命名规范，不再只是给你一个裸方法。带上“技术栈”则能避免它在 JPA 和 MyBatis 之间摇摆不定，防止生成和项目体系不一致的代码。

约束条件指的是你要主动告诉它想要的格式和边界。比如“不要使用Lombok，用传统getter/setter”或“不要生成XML，全用注解SQL”，它都会照做。这相当于把需求文档里最关键的几行约束提前告诉它，让它按你的规矩来，而不是你回头去迁就它的习惯。

4.2 高效场景：补全、测试、解释、查错

灵码除了生成新代码，还有几个日常效率极高的场景。首推单元测试生成。在 IDEA 里选中 Service 实现类，右键选择生成测试，灵码会自动生成 JUnit 5 的测试类，还会模拟 Mapper 依赖，生成基本的@Test方法。课设里写几个测试用例，答辩时是很加分的，但你不用把每个@Test都手敲一遍。

第二个场景是给代码补注释。有些项目要求 Javadoc 注释规范，写起来枯燥。把整个类粘贴给灵码，让它“给每个方法补充Javadoc注释，说明参数和返回值”，它生成的注释质量挺接近人工写的。但注意，注释里的内容一定要看一眼，防止它胡说，比如把返回学生列表写成返回老师列表，这种低级错误真的会出现。

第三个场景是代码解释。拿到一份旧项目代码，不知道某个 Service 方法为什么这么写，选中那段代码，右键让灵码解释，它会用中文给你拆解执行流程。这个功能我在读别人写的课设代码时帮了大忙，能省下一大半阅读理解的时间。

第四个场景是查错。控制台出现一个异常堆栈，直接复制粘贴给灵码，问“这是什么错误，为什么会出现，怎么解决”。它比搜索引擎好用的地方在于，它知道你项目上下文里用的什么框架，会结合 Spring Boot、MyBatis 的典型问题给方案。但方案不保证 100% 对，尤其涉及冷门版本问题，最后还是靠查官方文档验证。

4.3 人工审核不能省：AI 也会一本正经胡说

把 AI 写代码当成一个“水平还行但偶尔粗心”的结对同事，这个定位很重要。它会一本正经地编造不存在的配置项，比如给你写一个根本不存在的依赖版本号，或者推荐一个已经被废弃的 API。Java 生态版本变化太快，闭眼睛相信它，大概率要吃编译报错的苦。

我整理了一份“必须人工过目”的清单：

• SQL 是否用了#{}而不是${}。${}直接拼接字符串，存在 SQL 注入风险，AI 有时候为了省事会拼写成${name}。
• 事务是否加对地方。多表写操作时，Service 方法应该加@Transactional，AI 不会每次都主动加。
• 参数校验是否缺失。比如学号是否为空、年龄是否为负数，AI 生成的 Controller 往往没有防御性校验。
• 命名是否符合项目规范。AI 生成的变量名有时是a、b、list1，虽然能跑，但答辩老师看一眼就会皱眉。
• 不要把生产环境的数据库密码、密钥、个人信息粘贴到对话里。灵码的处理机制会分析你的代码，任何敏感数据都不应该出现在提示词里。如果公司有严格的代码保密制度，还得确认你们是否允许用云端 AI 插件处理代码。

记住一个原则：AI 负责把效率拉满，你负责把质量守住。那些“能跑但没校验”的代码，用起来总是会出问题的，尤其是课设功能一多，边界情况没处理，演示的时候一输入空值就崩，很尴尬。

5. IDEA + 灵码踩坑与排查实录

5.1 装不上灵码的排查

我在帮同事配置灵码时遇到过三种情况。第一种是插件市场搜不到，几乎可以断定是 IDEA 版本太老，2020.3 以下基本没戏，升级 IDEA 是最快的办法。第二种是能搜到但安装失败，提示网络问题，有些公司内网对插件市场限制比较严格，解决方式就是走离线安装包，前面第一章已经讲过。第三种是装完重启后右侧没有面板，那就到View → Tool Windows里找TONGYI Lingma，手动把面板调出来。

登录也出现过转圈不动的情况。刚装完第一次登录一直加载，后来发现是办公网出网不稳定，切换到个人网络后，扫码登录秒过。如果扫码后提示登录成功但面板没刷新，关掉 IDEA 重新打开就好。这类问题基本都是“网络 + 缓存”，不涉及什么高端技术。

5.2 IDEA 卡顿、启动慢、内存不足

装了灵码之后，IDEA 内存占用会高一些，如果你电脑配置一般不调内存，很容易卡到怀疑人生。我自己的习惯是打开Help → Change Memory Settings，把堆内存调到 1500MB 到 2048MB 之间。IDEA 启动时默认给的内存偏保守，遇到大项目根本不够用。

IDE 启动慢不全是内存的锅。Maven 依赖第一次下载特别慢，尤其是从中央仓库拉 Spring Boot 3 的包，等十几分钟都算正常的。解决方案是改maven/conf/settings.xml，配置国内 Maven 镜像仓库，速度能提升好几倍。另外，如果打开多个项目，IDEA 会同时索引所有项目的文件，建议只保留当前在做的项目，其他项目关闭。

代码格式化失效这个问题也常被问到。灵码生成的代码缩进经常跟你的 Code Style 不太一样，我用Ctrl + Alt + L格式化时偶尔没反应。先去Settings → Editor → Code Style确认语言对应的 scheme 有没有设置，再检查是否和其他软件的快捷键冲突。如果还是不行，直接让灵码“把这段代码按4空格缩进重新输出”，倒是也能解决。

5.3 生成代码编译报错与修复循环

灵码生成代码后编译报错，是所有人都会经历的事。遇到报错，先把完整错误信息复制到灵码对话框里，再加上一句话：“这是我的pom.xml依赖，请结合错误信息给出修复后的完整代码。”这样做它能结合具体依赖版本去分析，比自己看错误日志干瞪眼高效很多。

我遇到过频率最高的是这三类错误：

• Java 版本不匹配：本地 JDK 8，生成代码里用了var、List.of 这些新语法，编译直接挂。让灵码改用 JDK 8 兼容写法，或者把本地 JDK 升到 17。
• Maven 依赖版本冲突：Spring Boot 3 配 MyBatis 2.x，或者多个依赖包引用了不同版本的 Log4j，报一大堆ClassNotFoundException。解决办法是先把依赖版本统一，优先看 Spring Boot 父级版本管理。
• 找不到表或字段：项目运行时提示Table 'student_db.student' doesn't exist，多半是 SQL 脚本没执行，或者表名跟 Mapper 里的名字大小写对不上。让灵码检查@Table注解和建表语句即可。

AI 修复代码不是一次就能成功。我的经验是，把“修改后的完整类”再粘贴回 IDEA，编译如果再报错，就把新的报错继续喂回去，来回两三轮通常能收敛。如果连续三轮还报同样的错，果断手动看代码，AI 可能一直在用同一个错误思路。

5.4 运行环境与 IDEA 基础问题速查

最后把 IDEA 运行过程中一些常见的“小毛病”整理成速查表，都是我实际碰到过或者被学生问过的。

这张表面向的是“遇到问题能查到”的需求。真正常见的原因不外乎端口、编码、版本三板斧，任何一个环境问题先往这三个方向排查，八成能解决。如果看到一条报错实在不懂，就把报错完整复制给灵码再加一句“这是什么问题”，它会用更通俗的语言给你解释出一个方向来。

我个人在实际操作里的体会是，AI 写代码这件事，最舒服的姿势不是我完全不动脑子，而是“AI 出初稿、我出审查和决策”。学生管理系统这种项目，功能成熟、业务固定，让灵码来写大头是顺势而为的事，但每生成一段代码，我都会在自己脑子里过一遍业务逻辑：这个字段该不该必填，这个删除操作要不要二次确认，这条 SQL 会不会影响别的表。想清楚这些，AI 给你写的代码才真正算“你的作品”。

最后再分享一个小习惯：每次项目跑通后，把灵码生成代码时用过的高质量提示词单独存成一个文本文件。课设做完了，下个项目再遇到类似的 CRUD 场景，直接把提示词改个表名就能复用，越存越顺手。AI 工具用得好不好，差的往往不是模型能力，而是你有没有把自己的需求描述清楚。