---
title: 开发实施原则
type: rule
permalink: main/global/开发实施原则
stable_id: bf88c265-4749-4c50-85bc-4bae25298cd5
scope: global
memory_type: rule
project_id: null
status: active
revision: 4
request_id: ff637b9f-54a3-4f33-b4f2-ff089b3fa15f
updated_at: '2026-08-05T12:19:24.102240+00:00'
tags:
- global
- rule
- development
created_at: '2026-08-02T09:39:33.919260+00:00'
usage_profile_id: 7aee455b-24cc-4008-bdaf-443721e6f939
---

# 开发实施原则

- 遵循 KISS 与 YAGNI，使用最简单且正确的实现。
- 优先复用项目已有框架、服务、工具和约定，不建立重复实现。
- 不添加为假设未来需求服务的依赖、抽象或基础设施。
- 修改范围与当前目标一致，测试覆盖随风险扩大；完成前清理临时内容和无用代码。
- 前端以真实工作流、桌面可用性、信息层级和无重叠为验收标准。
- Web 表单优先使用“标题在左、控件在右”的紧凑横向布局；Markdown、代码、备注等较大或多行内容使用“标题在上、内容在下”，并根据实际场景调整。
- Web 页面顶部标题区域在内容滚动时保持可见，页面操作继续放在标题区域右侧。
- Web 提示说明放在对应页面、分区或字段标题旁，以提示图标呈现并在鼠标悬停后显示；错误、警告和关键状态仍应直接展示。
- Web 弹窗的保存、取消等操作区域固定显示，不随正文滚动离开视口。
- Markdown 编辑/预览、多行文本、日志和长列表优先在控件内部滚动，并根据桌面浏览器可用高度自适应；避免让整个页面或弹窗承担长内容滚动。
- 表单标签列、控件列和分组间距保持紧凑一致，避免大面积无意义留白；标签页和列表需保留清晰内边距，不能贴边或被遮挡。