SyntaxEditor 1.0.0
See the version list below for details.
dotnet add package SyntaxEditor --version 1.0.0
NuGet\Install-Package SyntaxEditor -Version 1.0.0
<PackageReference Include="SyntaxEditor" Version="1.0.0" />
<PackageVersion Include="SyntaxEditor" Version="1.0.0" />
<PackageReference Include="SyntaxEditor" />
paket add SyntaxEditor --version 1.0.0
#r "nuget: SyntaxEditor, 1.0.0"
#:package SyntaxEditor@1.0.0
#addin nuget:?package=SyntaxEditor&version=1.0.0
#tool nuget:?package=SyntaxEditor&version=1.0.0
CSHARP 高亮语法编辑器
轻量、高性能、自绘的 C# WinForms 语法高亮编辑器控件,基于 .NET 8,零第三方依赖。
项目结构
SyntaxHighlightEditor.sln
src/
SyntaxEditor/ ← 控件库(NuGet 包的本体)
SyntaxTextBox.cs ← 控件本体(绘制/编辑/滚动/选区/折叠/查找)
SyntaxTextBox.Completion.cs ← 代码补全(partial,可整体删除而不影响本体)
SyntaxTextBox.Ime.cs ← IME 候选框跟随(partial,可整体删除而不影响本体)
TextDocument.cs ← 文本行存储
CSharpLanguage.cs ← C# 手写扫描式词法器(单行 O(n),无正则回溯)
RegexLanguage.cs ← 通用正则语言定义,10 行代码接入新语言
EditorTheme.cs ← 配色主题(VS 深色 / 浅色,字段全可改)
Token.cs / Position.cs ← 基础结构
Demo/ ← 演示程序(打开/保存、主题切换、SQL 高亮示例)
性能策略(为什么快)
| 策略 | 说明 |
|---|---|
| 虚拟化渲染 | 每次重绘只画可见的几十行,大文件滚动不卡 |
| 逐行词法缓存 | 每行缓存 Token 数组 + 行版本号 + 进入行时的词法状态,只有改过的行才重新着色 |
| 手写扫描器 | C# 词法器是单次顺序扫描,无正则回溯,单行 O(n) |
| 等宽列定位 | 字宽只量一次,坐标 = 列 × 字宽,无逐字 MeasureString |
| 双缓冲 | OptimizedDoubleBuffer + GDI 文本/GDI+ 矩形混合绘制,无闪烁 |
安装
在 WinForms 项目(net8.0-windows,启用 WinForms)中:
dotnet add package SyntaxEditor
快速上手
using SyntaxEditor;
var editor = new SyntaxTextBox {
Dock = DockStyle.Fill,
Language = new CSharpLanguage(),
Theme = EditorTheme.VisualStudioDark // 或 EditorTheme.Light / 自定义
};
editor.Text = File.ReadAllText("Program.cs");
Controls.Add(editor);
代码补全
editor.AddCompletionWords("foo", "bar"); // 手动加词
editor.AddCompletionAssembly(typeof(Program).Assembly);// 程序集导出类型名 + 枚举成员名
editor.AddCompletionStaticMethods(typeof(Console)); // 公共静态方法名
editor.AddCompletionInstanceMethods(typeof(String)); // 公共实例方法名
editor.LoadCSharpCompletionDefaults(asm, globalsType, "input", "output"); // 一行全装配
匹配优先级:前缀 > 驼峰缩写(gb → GaussianBlur)> 包含。输入字母/下划线自动弹出;Enter/Tab 接受,↑↓ 移动,PgUp/PgDn 翻页,Esc 关闭;确认并入撤销栈(一次 Ctrl+Z 撤回)。AutoCompleteEnabled = false 可整体关闭。
接入其它语言(示例:SQL)
editor.Language = new RegexLanguage {
LineComment = "--", BlockCommentStart = "/*", BlockCommentEnd = "*/" }
.AddPattern(TokenKind.String, "'([^']|'')*'")
.AddPattern(TokenKind.Number, @"\b\d+(\.\d+)?\b")
.AddKeywords(TokenKind.Keyword, "select", "from", "where", "insert", "update", "delete");
已支持 / 已知限制
已支持:行号栏、光标闪烁、鼠标/Shift 选择、双击选词、Ctrl+A/C/X/V、自动缩进(回车继承上一行缩进)、横纵滚动条与滚轮、深浅主题、打开/保存、撤销/重做(Ctrl+Z / Ctrl+Y,连续输入与退格自动合并成一步)、代码折叠(大括号块与 #region,点行号旁的 [−]/[+] 或按 Ctrl+M,ToggleFold / CollapseAllFolds / ExpandAllFolds API)、右键菜单(撤销/剪切/复制/粘贴/全选/查找/转到定义/转到实现)、查找面板(Ctrl+F,匹配全亮 + 当前匹配高亮,↑↓/Enter/Shift+Enter 跳转,Esc/× 关闭后高亮自动消失,F3 静默跳到下一个)、转到定义 F12 / 转到实现 Ctrl+F12(启发式整词匹配)、全角中文字符逐列宽度对齐(光标/选区与文字精确对位)、拖选到视口边缘自动滚动、中文输入法 IME 候选框跟随光标(组词期间自动暂停补全)、Ctrl+滚轮缩放字号(6~48pt,行号栏/折叠栏悬停自动切回箭头光标)、代码补全(前缀 > 驼峰缩写 > 包含三档匹配;词库可手动加词或反射收集程序集/类型的类型名、枚举成员、公共方法;Enter/Tab 确认且并入撤销栈)。
已知限制(为保持轻量刻意省略,需要时可自行扩展):
- 补全是词库匹配(关键字 + 反射收集的 API 名),不做语义分析;
.后的成员级精确提示需要 Roslyn,不在轻量方案范围内 - 查找暂不支持正则/大小写开关(固定忽略大小写的普通文本匹配)
- 无垂直折叠参考线(折叠仅显示 [+]/[−] 标记)
- "转到定义/实现"为启发式整词匹配,不依赖 Roslyn,语义精度有限
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0-windows7.0 is compatible. net9.0-windows was computed. net10.0-windows was computed. |
-
net8.0-windows7.0
- No dependencies.
NuGet packages (1)
Showing the top 1 NuGet packages that depend on SyntaxEditor:
| Package | Downloads |
|---|---|
|
VisionFlow
视觉流程图框架:流程图引擎([FlowNode] 节点注册、JSON 序列化、拓扑执行、配方)+ WinForms 编辑器控件 + csx 脚本 / .cs 源码 / DLL 算子包四种扩展载体。内置视觉算子(旋转模板匹配/综合测量/OCR/读码/颜色抽取/深度学习目标检测)随包自动部署,装一个包即可用。 |
GitHub repositories
This package is not used by any popular GitHub repositories.