Cursor 使用秘籍：提升编程效率的必备规则-程序员充电站

我的 Cursor 编程设计实践：高效构建优质代码

在代码架构设计与开发实践中，我严格遵循以下准则，以确保代码的高质量、可维护性和可扩展性，可以将以下的规则复制到Cursor的User Rules中：

一、架构分析与模块设计阶段

第一性原理思考：
- 第一性原理在智能照明系统设计中的应用
  在运用第一性原理对智能照明系统进行设计时，我们摒弃了直接套用通用模板的做法，转而从系统的基本功能和用户核心需求出发，逐步构建起整个架构。
  我们首先明确了智能照明系统的核心目标是依据用户设定和环境状况，精准调控照明设备的开关与亮度。围绕这一目标，进一步剖析用户在实际场景中的需求：用户期望通过手机应用远程操控照明设备、根据环境光强自动调节亮度、设置定时开关以及实现不同场景下的一键切换等功能。
  基于此，我们将系统分解为基础组件。环境光强传感器作为关键部件，负责实时监测环境光亮度；微控制单元（MCU）承担核心控制职责，运行控制算法；通信模块则实现手机应用与照明系统的无线连接，支持 Wi-Fi 或蓝牙协议；照明驱动电路根据 MCU 发出的指令精准调控灯具的开关与亮度；电源管理模块保障整个系统的稳定供电，包括电源的转换与分配。
  在深入理解各组件特性的同时，我们梳理了它们的相互关系。例如，环境光强传感器将实时数据传输至 MCU，MCU 进而结合预设算法进行运算，通过通信模块接收用户指令并与传感器数据融合处理，最终由照明驱动电路执行灯具的调控动作。
  通过这一过程，我们成功构建出一个智能照明系统的架构，不仅贴合用户实际需求，还具备高度的灵活性和可扩展性，为后续的功能升级和优化奠定了坚实基础。

二、编码阶段

DRY（Don’t Repeat Yourself，不重复自己）原则：努力避免代码重复。当发现有相似的代码片段出现在多个地方时，会将其抽取为一个可重用的函数、类或模块。比如，在多个地方都需要对数据进行验证，就创建一个通用的验证工具类，供各个需要验证数据的地方调用。
KISS（Keep It Simple, Stupid，保持简单，愚蠢）原则：使代码保持简洁明了，易于理解和维护。尽量避免不必要的复杂逻辑和过度设计。如果一个功能可以通过简单的算法和数据结构实现，就不会引入复杂的框架或设计模式。例如，对于一些简单的数据存储和检索需求，使用数组和哈希表就可以满足，而不是直接上大型的数据库框架。
SOLID 原则
- 单一职责原则：一个类或模块只负责一个功能领域中的相应职责。以一个用户管理模块为例，将用户注册、用户登录、用户信息修改等功能分别放在不同的类中，每个类专注于处理自己对应的功能。
- 开放 - 关闭原则：软件实体应当对扩展开放，对修改关闭。当需要增加新功能时，尽量通过添加新的代码，而不是修改已有的、经过测试和验证的代码。比如，在一个图形绘制软件中，如果要增加新的图形类型，就创建新的图形类继承自基本图形类，而不是修改已有的图形绘制类。
- 里氏替换原则：在软件中，子类对象应当能够替换父类对象被使用，并且不会产生任何错误或异常。例如，有一个鸟类的父类，麻雀类和鸵鸟类继承自鸟类。如果鸟类有一个飞翔的方法，麻雀类可以重写这个方法实现自己的飞翔逻辑，但鸵鸟类由于不会飞翔，在重写飞翔方法时，不能破坏原有的方法调用的正确性，要确保在原本使用鸟类对象的地方，替换为鸵鸟类对象也不会出错。
- 接口隔离原则：为依赖于它的客户创建一些专门的接口，而不是强迫客户依赖于它们不用的接口。比如，有一个打印机接口，原本包含了打印、复印、扫描等多种功能的方法。但有些客户只需要打印功能，那么就可以将这些功能分开到不同的接口中，让客户只依赖自己需要的打印接口。
- 依赖倒置原则：高层模块不应依赖于低层模块，二者都应该依赖于抽象；抽象不应依赖于细节，细节应依赖于抽象。例如，在一个数据处理系统中，数据处理模块（高层模块）不直接依赖于具体的数据库操作类（低层模块），而是依赖于数据库访问的抽象接口。具体的数据库操作类实现这个抽象接口，这样高层模块和低层模块都通过抽象接口进行交互，提高了代码的灵活性和可维护性。
YAGNI（You Aren’t Gonna Need It，你不会需要它）原则：不要在当前不需要的时候就去添加额外的功能和特性。专注于当前的需求，避免过度设计和开发。例如，在开发一个简单的命令行工具时，不要因为觉得以后可能会有图形界面需求，就提前在代码中加入图形界面相关的框架和代码，等真正需要图形界面时，再进行相应的开发。