1. 项目背景与整体设计思路
1.1 为什么拿“学生信息”当练手项目
要做一个学生信息管理系统，绕不开的最基础功能就是增删改查。我见过不少初学者一上来就去找商城、博客、订单这类项目练手，结果被权限体系、购物车状态、支付回调这些业务逻辑拖住，数据库操作反而没吃透。所以我还是推荐先用“学生信息”这种经典场景起步：字段不多不少，既有字符串又有数字和日期，覆盖了增删改查里最常见的类型处理。
这套项目用的是 VS2019 社区版 + C# WinForms + MySQL 8.0，核心就一句话：界面上录入学生信息，点按钮写入 MySQL；选中列表里的某一行，点按钮把它删掉。本期是系列第一篇，只做“增”和“删”两个动作，“改”和“查”放在下一篇。并不是说改查不重要，而是增删这两个动作涉及到的连接管理、参数化SQL、影响行数判断、界面刷新这些基础点一旦吃透，后面改查就是照葫芦画瓢。
1.2 技术选型：VS2019、C#、MySQL 各承担什么
很多人在选型上纠结：为什么不用 SQL Server？为什么不用 WPF？为什么不用控制台？我逐个说一下我的理由。
- VS2019：社区版免费，工作负载勾选“.NET 桌面开发”就能用，环境成本几乎为零。VS2022 虽然也出了，但 VS2019 依然是很多公司还在用的版本，教程按 VS2019 写，兼容性反而更好。
- C# + WinForms：WinForms 拖拽控件就能出界面，代码量比 WPF 少得多。对于“数据库增删改查”这种以数据操作为核心的需求，WinForms 的 DataGridView 和 TextBox 组合起来非常顺手。控制台虽然更聚焦，但看不到数据在表格里刷新的效果，学习成就感低。
- MySQL：免费、安装包不大、资料多，而且 MySQL 的 SQL 语法和 SQL Server 有细微差别，比如自增列写法、LIMIT 分页，提前用 MySQL 练手，后面遇到真实项目迁移也能更快适应。
另外提一个很多人问过的问题：MySql.Data这个驱动库一定要通过 NuGet 装，不要手动去网上找个 DLL 就往项目里扔。NuGet 会帮你处理依赖和版本，出问题也好排查。后面我还会专门讲一个和它相关的坑。
1.3 系列文章规划：增删改查分两期写的理由
增删改查四个功能，我故意拆成两篇：先讲“增删”，再讲“改查”。原因是这两个组合的技术侧重点不一样。
“增删”的核心在于：如何安全地拼接用户输入、如何判断操作影响的行数、如何在操作后刷新列表。这两个操作一旦出错，轻则抛异常，重则可能删错数据，所以需要用 MessageBox 做二次确认。
“改查”的核心则在于：如何回填选中行数据、如何构造 UPDATE 语句、如何做模糊搜索和分页。逻辑链条比增删长，单独一篇能讲得更细。这种拆分方式也方便读者按需查阅，不用为了看一个删除功能翻一大篇文章。
2. 环境准备与数据库设计
2.1 开发环境搭建
先说环境。VS2019 的安装路径一般默认在 C 盘，如果你像我一样想装到 D 盘，安装器里选自定义路径即可。安装时一定记得勾选“.NET 桌面开发”工作负载，这个工作负载包含了 WinForms 所需的所有组件。如果勾漏了，后面新建项目时找不到“Windows 窗体应用”，还得回头补装，非常麻烦。
MySQL 的安装，我建议用 MySQL Installer 的 Developer Default 模式，它会顺带装上 MySQL Workbench 和 MySQL Shell。Workbench 用来建库建表、执行 SQL 很方便，比命令行对新手友好太多。安装过程中会让你设置 root 密码，这个密码一定要记牢，后面连接字符串里要用。
安装完 MySQL 后，打开 Windows 服务管理器确认 MySQL 服务状态是“正在运行”，这一步很多人忽略，导致后面 C# 程序连接时报“无法连接到任何指定的 MySQL 主机”，实际上就是服务没起来。
数据库装好后，在 VS2019 里新建一个 Windows 窗体应用（.NET Framework），然后在“工具—NuGet 包管理器—管理解决方案的NuGet程序包”里搜索MySql.Data，选择最新稳定版安装。这里提醒一句：MySQL 8.0 的默认认证插件是caching_sha2_password，老版本的 MySql.Data 可能连不上，所以尽量装 8.0.x 以上的版本。
2.2 建表语句与字段说明
我用 Workbench 执行下面这段 SQL，建一个StudentDB库和Student表：
CREATE DATABASE IF NOT EXISTS StudentDB DEFAULT CHARACTER SET utf8mb4; USE StudentDB; DROP TABLE IF EXISTS Student; CREATE TABLE Student ( Id INT PRIMARY KEY AUTO_INCREMENT COMMENT '主键、自增', StudentNo VARCHAR(20) NOT NULL COMMENT '学号', Name VARCHAR(50) NOT NULL COMMENT '姓名', Gender CHAR(1) DEFAULT '男' COMMENT '性别', Age INT DEFAULT 0 COMMENT '年龄', ClassName VARCHAR(50) DEFAULT '' COMMENT '班级', Phone VARCHAR(20) DEFAULT '' COMMENT '手机号', CreateTime DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;字段设计上，我特意保留了StudentNo（学号）和Name（姓名）两个 NOT NULL 字段，用来演示“必填校验”。Id用自增主键，好处是新增时不用手动传 Id，数据库自己分配，避免并发场景下主键冲突。CreateTime用DEFAULT CURRENT_TIMESTAMP，插入数据时如果没传这个字段，数据库会自动填当前时间。
字符集统一用utf8mb4，而不是utf8，因为utf8在 MySQL 里最多只支持 3 个字节，遇到 emoji 这类 4 字节字符会报错。虽然学生表里大概率不会存 emoji，但养成好习惯能少踩一个坑。
2.3 连接字符串配置与读取
在项目里添加一个应用程序配置文件App.config，写入连接字符串：
<?xml version="1.0" encoding="utf-8" ?> <configuration> <connectionStrings> <add name="MySqlConnection" connectionString="Server=localhost;Database=StudentDB;Uid=root;Pwd=你的密码;Charset=utf8mb4;SslMode=None;" providerName="MySql.Data.MySqlClient" /> </connectionStrings> </configuration>这里有两个容易踩坑的配置项：
Charset=utf8mb4：没加的话，中文在部分环境下可能出现乱码。虽然 Connector/NET 默认字符集可能没问题，但显式声明更稳妥。SslMode=None：MySQL 8.0 默认启用 SSL 连接，本地开发时如果没配置证书，连接可能会报 SSL 错误。本地开发用None就够了。
在 C# 代码里通过ConfigurationManager读取：
using System.Configuration; private static string connStr = ConfigurationManager.ConnectionStrings["MySqlConnection"].ConnectionString;如果没有 System.Configuration 这个引用，需要在项目里手动添加引用，这是新手很容易卡住的地方。
3. 数据访问层的封装
3.1 为什么要把数据库操作封装成 DBHelper
很多初学 C# 的人第一次写连接数据库的代码，是每个窗体事件里都写一遍MySqlConnection、MySqlCommand、DataAdapter。我之前也这么干过，后来发现两个问题：一是代码严重重复，一个项目里光连接对象的创建就有十几处；二是如果哪天连接字符串变了，比如密码改了，得把所有窗体翻一遍。
所以我在这个项目里做了一个简单的DBHelper静态类，把“执行查询返回 DataTable”和“执行增删改返回影响行数”这两个高频操作统一封装。窗体层只需要传 SQL 和参数，不用关心连接怎么开、怎么关、异常怎么处理。
这里要特别说明：DBHelper 不是越复杂越好，初学者不要一上来就仿照网上那种带连接池、带事务、带日志的“通用框架”。这个阶段封装两个方法够用就行，等真遇到高并发场景，再考虑引入更重的数据访问框架。
3.2 DBHelper 完整代码
using System.Configuration; using System.Data; using MySql.Data.MySqlClient; public class DBHelper { private static readonly string connStr = ConfigurationManager.ConnectionStrings["MySqlConnection"].ConnectionString; public static DataTable Query(string sql, MySqlParameter[] parameters = null) { using (MySqlConnection conn = new MySqlConnection(connStr)) { conn.Open(); using (MySqlCommand cmd = new MySqlCommand(sql, conn)) { if (parameters != null) cmd.Parameters.AddRange(parameters); DataTable dt = new DataTable(); using (MySqlDataAdapter adapter = new MySqlDataAdapter(cmd)) { adapter.Fill(dt); } return dt; } } } public static int ExecuteNonQuery(string sql, MySqlParameter[] parameters = null) { using (MySqlConnection conn = new MySqlConnection(connStr)) { conn.Open(); using (MySqlCommand cmd = new MySqlCommand(sql, conn)) { if (parameters != null) cmd.Parameters.AddRange(parameters); return cmd.ExecuteNonQuery(); } } } }这里用using块来管理连接和命令对象，方法执行完，连接会自动释放。很多人写代码不习惯用using，连接用完不关，本地测试感觉不到问题，一旦放到服务器上跑几天，连接池耗尽，程序就卡死了。所以从第一课就养成用using的习惯，后面会省很多事。
3.3 关于参数化 SQL：为什么永远不要拼字符串
我在不少教程里见过这种写法：
string sql = "INSERT INTO Student (Name) VALUES ('" + txtName.Text + "')";这段代码在功能上确实能跑，但它有两个致命问题。第一是 SQL 注入，用户在文本框里输入'); DROP TABLE Student; --这种内容，拼出来的 SQL 就成了破坏性语句。第二是引号转义，用户名字里如果带了单引号，比如O'Brien，拼接后的 SQL 直接语法错误。
参数化 SQL 的写法是把用户输入当作参数传给数据库，而不是拼接进 SQL 字符串。数据库驱动会正确处理特殊字符，也能防止恶意内容被当成 SQL 执行。所以在这期项目里，不管是一条 INSERT 还是一条 DELETE，我都用了MySqlParameter传参。这个习惯强烈建议从练手阶段就固定下来，别等项目上线再去还技术债。
4. 增删功能完整实现
4.1 窗体界面布局
在 WinForms 里，我拖了这些控件：
- 6 个 TextBox：学号、姓名、年龄、班级、手机号
- 1 个 ComboBox：性别（下拉项为“男”“女”）
- 2 个按钮：新增、删除
- 1 个 DataGridView：用来展示当前表里所有学生数据
布局没有固定标准，做到“输入区域在上方，按钮在中部，表格占下方大头”这种直觉布局就够了。关键是给 DataGridView 几个列设置中文表头，不然用户看到的是 Id、StudentNo 这种英文字段名，体验太差。
我给 DataGridView 加上列的方式是直接跑一句 SQL 查询，再把结果集绑定到 DataSource，同时通过 SQL 别名把列名映射成中文，这样就不用手动一列一列去配置，省事很多。后面讲刷新列表时会贴出这行关键的 SQL。
4.2 添加学生功能实现
新增按钮的点击事件，我拆成四步：读取输入、必填校验、执行插入、刷新列表。
private void btnAdd_Click(object sender, EventArgs e) { string studentNo = txtStudentNo.Text.Trim(); string name = txtName.Text.Trim(); string gender = cmbGender.Text.Trim(); int age = 0; int.TryParse(txtAge.Text.Trim(), out age); string className = txtClassName.Text.Trim(); string phone = txtPhone.Text.Trim(); if (string.IsNullOrEmpty(studentNo) || string.IsNullOrEmpty(name)) { MessageBox.Show("学号和姓名不能为空"); return; } string sql = @"INSERT INTO Student (StudentNo, Name, Gender, Age, ClassName, Phone) VALUES (@StudentNo, @Name, @Gender, @Age, @ClassName, @Phone);"; MySqlParameter[] parameters = { new MySqlParameter("@StudentNo", studentNo), new MySqlParameter("@Name", name), new MySqlParameter("@Gender", gender), new MySqlParameter("@Age", age), new MySqlParameter("@ClassName", className), new MySqlParameter("@Phone", phone) }; int rows = DBHelper.ExecuteNonQuery(sql, parameters); if (rows > 0) { MessageBox.Show("添加成功"); LoadStudentList(); ClearInputs(); } else { MessageBox.Show("添加失败"); } }这里用到Trim()去掉用户输入前后的空格，避免误输入一个空格导致校验通过。年龄用int.TryParse做转换，如果用户填的不是数字或者留空，age就是 0，既不会抛异常，也能被数据库接受。
判断是否成功的标准是ExecuteNonQuery的返回值，它表示受影响的行数。插入一行数据返回 1，返回 0 就说明 SQL 执行了但没有实际插入，这种情况通常是 WHERE 条件不匹配，INSERT 场景下少见，但 DELETE 场景很常用。
4.3 删除学生功能实现
删除的界面逻辑是：先在 DataGridView 里选中一行，然后点删除按钮。这里有两个关键点：第一是拿当前选中行的主键 Id，第二是删除前必须弹确认框。
private void btnDelete_Click(object sender, EventArgs e) { if (dgvStudents.CurrentRow == null) { MessageBox.Show("请先选择要删除的行"); return; } int id = Convert.ToInt32(dgvStudents.CurrentRow.Cells["Id"].Value); string name = dgvStudents.CurrentRow.Cells["Name"].Value.ToString(); DialogResult result = MessageBox.Show( $"确定要删除学生“{name}”吗？删除后不可恢复。", "删除确认", MessageBoxButtons.YesNo, MessageBoxIcon.Warning); if (result != DialogResult.Yes) { return; } string sql = "DELETE FROM Student WHERE Id = @Id;"; MySqlParameter[] parameters = { new MySqlParameter("@Id", id) }; int rows = DBHelper.ExecuteNonQuery(sql, parameters); if (rows > 0) { MessageBox.Show("删除成功"); LoadStudentList(); } else { MessageBox.Show("删除失败"); } }删除确认框不能省。实际项目里误删数据的成本非常高，虽然我们这期是本地 Demo，但养成“删除前弹确认”的习惯非常必要。
按 Id 删除而不是按姓名删除，是因为 Id 是主键，唯一且稳定。姓名有可能重名，如果按姓名删，一删就是好几条，很容易误伤。
4.4 刷新列表与整体联调
新增和删除之后都要重新查一次数据库，让 DataGridView 显示最新数据：
private void LoadStudentList() { string sql = @"SELECT Id, StudentNo AS 学号, Name AS 姓名, Gender AS 性别, Age AS 年龄, ClassName AS 班级, Phone AS 手机号, CreateTime AS 创建时间 FROM Student ORDER BY Id DESC;"; DataTable dt = DBHelper.Query(sql); dgvStudents.DataSource = dt; dgvStudents.Columns["Id"].Visible = false; }把 Id 列隐藏掉，是因为它只是用来定位删除行的内部主键，展示给用户没意义。Sql里用了ORDER BY Id DESC，新插入的数据会显示在表格最上面，视觉反馈更明显。
最后再补一个ClearInputs方法，把输入框清空，性别重置为“男”，方便连续添加：
private void ClearInputs() { txtStudentNo.Text = ""; txtName.Text = ""; txtAge.Text = ""; txtClassName.Text = ""; txtPhone.Text = ""; cmbGender.SelectedIndex = 0; }到这里，增删两个核心功能就能完整跑通了。
5. 常见问题与排查技巧实录
5.1 连接数据库失败，报“无法连接到任何指定的 MySQL 主机”
这个错误八成不是代码问题，而是环境问题。按顺序排查：MySQL 服务有没有启动，连接字符串的 Server 和 Port 对不对，root 密码是否正确，3306 端口有没有被防火墙挡住。
我见过一个比较隐蔽的情况：电脑上装了多个 MySQL 实例，比如 5.7 和 8.0 同时存在，3306 端口被旧实例占用，新实例用的 3307，连接字符串里却写的默认端口，自然连不上。用 Workbench 能连、C# 连不上的时候，重点查你实际连的端口和密码。
5.2 报“Authentication method 'caching_sha2_password' failed”
这是 MySQL 8.0 默认认证插件和旧版驱动不兼容导致的。解决办法优先更新 MySql.Data 到 8.0 以上。如果项目比较老无法升级，也可以在 MySQL 里执行：
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';但我不推荐长期用这个方案，毕竟驱动是不断更新的，尽量让你的驱动匹配数据库版本。
5.3 插入或删除后界面没变化
先手动在 Workbench 里执行一下 SQL，看看数据到底有没有变。如果数据变了但界面没刷新，说明没调用LoadStudentList()；如果数据也没变，说明 SQL 执行失败了，而你又没看到异常。
这里有个新手很容易踩的坑：ExecuteNonQuery返回 0 不代表异常，比如 DELETE 的 WHERE 条件没匹配到任何行，BCL 不会抛错，只会悄悄返回 0。所以代码里一定要体现出“rows > 0 才能提示成功”的逻辑，这样问题就能定位到条件是否匹配。
5.4 中文乱码
乱码问题 90% 是字符集不一致。检查三处：MySQL 表字符集是否为 utf8mb4，连接字符串里有没有Charset=utf8mb4，DataGridView 里显示的内容是否在写入前就已经是乱码。如果是写入前就乱，那是输入框的问题；如果写入后从数据库查出来才乱，才是字符集的问题。
5.5 DataGridView 删除时报“列 Id 不存在”或取值不对
我在示例里用dgvStudents.CurrentRow.Cells["Id"].Value取主键，前提是生成的 DataGridView 列名和 SQL 里的字段名一致。如果你手动配置过列，或者查询时用了别名，列名可能已经变了，取值时就要用实际列名。最稳妥的办法是删除前用 MessageBox 或者断点看一眼CurrentRow.Cells都有哪些列。
还有一种情况是用户对表格重新排序或者分了页，CurrentRow指向的行不是你以为的那一行。对于本期这种单页数据量，问题不大；以后做分页时要注意，取当前行 Id 的逻辑在分页后要重新处理。
6. 一些实打实的体会
这期代码写下来，我最想留给大家的一段经验是：不要嫌流程繁琐。新增前校验、删除前确认、操作后刷新，每一步都有人觉得“是不是多余”，但实际项目里，正是这些“多余”的检查拦下了大量低级事故。
另外关于 MySQL 连接这个事，我再提一句：本地调试建议把连接字符串写到 App.config 里，不要写死在代码中。我见过有人把连接字符串直接嵌在DBHelper里，后来数据库密码一改，整个项目找连接字符串找半天。
本期只讲了增和删，下一篇我会把“改”和“查”补完，重点是选中行一键回填到输入框、UPDATE 语句怎么配合 Id 精确更新、以及带条件的模糊查询和分页。你可以先把增删的代码敲熟，尤其把参数化 SQL 和影响行数判断这两个点消化掉，后面学起来会快很多。
