示例：完整的用户管理模块

/* 
用户管理模块

功能：
- 管理系统用户的基本信息
- 处理用户的注册、登录和权限管理
- 记录用户的操作日志

表结构：
- users：存储用户基本信息
- user_roles：存储用户角色
- user_permissions：存储用户权限
- user_logs：存储用户操作日志

创建日期：2026-04-01
作者：数据库管理员
*/

-- 创建用户表
CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY, -- 用户ID
    username VARCHAR(50) NOT NULL UNIQUE, -- 用户名
    email VARCHAR(100) NOT NULL UNIQUE, -- 电子邮件
    password VARCHAR(255) NOT NULL, -- 密码（加密存储）
    first_name VARCHAR(50), -- 名
    last_name VARCHAR(50), -- 姓
    status ENUM('active', 'inactive', 'deleted') DEFAULT 'active', -- 用户状态
    last_login TIMESTAMP NULL, -- 最后登录时间
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, -- 创建时间
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP -- 更新时间
);

-- 创建用户角色表
CREATE TABLE user_roles (
    id INT AUTO_INCREMENT PRIMARY KEY, -- 角色ID
    user_id INT NOT NULL, -- 用户ID
    role_name VARCHAR(50) NOT NULL, -- 角色名称
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, -- 创建时间
    FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
);

-- 创建索引
CREATE INDEX idx_users_status ON users(status); -- 加速状态查询
CREATE INDEX idx_user_roles_user_id ON user_roles(user_id); -- 加速用户角色查询

/* 
获取用户及其角色的存储过程
参数：
  user_id - 用户ID
返回：
  用户基本信息和所属角色
*/
DELIMITER //
CREATE PROCEDURE sp_get_user_with_roles(IN user_id INT)
BEGIN
    -- 查询用户基本信息
    SELECT * FROM users WHERE id = user_id;
    
    -- 查询用户角色
    SELECT r.role_name 
    FROM user_roles r
    WHERE r.user_id = user_id;
END //
DELIMITER ;

/* 
用户登录触发器
功能：更新用户最后登录时间
*/
DELIMITER //
CREATE TRIGGER after_user_login
AFTER UPDATE ON users
FOR EACH ROW
BEGIN
    -- 当状态从inactive变为active时，更新最后登录时间
    IF OLD.status = 'inactive' AND NEW.status = 'active' THEN
        UPDATE users SET last_login = NOW() WHERE id = NEW.id;
    END IF;
END //
DELIMITER ;
            

8. 常见错误与解决方案

8.1 注释语法错误

错误：多行注释未正确结束

解决方案：确保每个/*都有对应的*/

8.2 注释与代码冲突

错误：注释中的内容影响了代码的执行

解决方案：确保注释不会干扰代码的语法 05更多学习教程公众号风哥教程itpux_com

8.3 过时的注释

错误：注释与代码不一致

解决方案：修改代码时同时更新注释

8.4 过度注释

错误：注释过多，影响代码可读性

解决方案：只注释必要的部分，保持代码简洁

9. 总结

本教程介绍了MySQL注释的规则与使用方法，包括： 06 from mysql视频:www.itpux.com

• MySQL支持的三种注释类型：单行注释、多行注释和井号注释
• 注释的使用场景：表结构注释、复杂查询注释、存储过程和函数注释、触发器注释、调试注释
• 注释的最佳实践：一致性、简洁明了、避免冗余、及时更新
• 注释的注意事项：与代码同步、避免过度注释、注意特殊字符、考虑性能影响
• 注释的工具支持：MySQL Workbench、代码编辑器、文档生成工具

良好的注释是数据库开发的重要组成部分。通过使用适当的注释，可以提高代码的可读性和可维护性，促进团队协作，减少错误。在实际项目中，应根据具体情况制定适合的注释规范，并确保团队成员严格遵守。