SyntaxEditor 1.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package SyntaxEditor --version 1.0.0
                    
NuGet\Install-Package SyntaxEditor -Version 1.0.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SyntaxEditor" Version="1.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SyntaxEditor" Version="1.0.0" />
                    
Directory.Packages.props
<PackageReference Include="SyntaxEditor" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add SyntaxEditor --version 1.0.0
                    
#r "nuget: SyntaxEditor, 1.0.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package SyntaxEditor@1.0.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=SyntaxEditor&version=1.0.0
                    
Install as a Cake Addin
#tool nuget:?package=SyntaxEditor&version=1.0.0
                    
Install as a Cake Tool

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 Compatible and additional computed target framework versions.
.NET net8.0-windows7.0 is compatible.  net9.0-windows was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • 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.

Version Downloads Last Updated
1.0.2 243 9/28/2026
1.0.0 107 9/27/2026