<p>StringSyntax仅支持标注在字符串参数、字段/属性、局部变量三种位置，且需C# 12+、VS 2022 17.4+并启用“增强的字符串字面量支持”，不支持const、readonly、返回值等场景。</p>
StringSyntax 不是运行时校验机制，加了它代码照样能编译通过、照样会崩——它只影响 IDE 的编辑体验，且仅在特定条件下生效。
StringSyntax 能用在哪些地方？
必须是字符串类型，且只能标注在以下三种位置：
- 字符串参数：例如
void Parse([StringSyntax("json")] string input) - 字符串字段或属性：例如
public string Config { get; set; }上加[StringSyntax("json")] - 字符串局部变量：例如
string [StringSyntax("regex")] pattern = @"\d+";（注意：C# 12+ 且需开启预览语言版本）
不能用在：const string、readonly string、非字符串类型、方法返回值、泛型约束里。传入非法语法名如 "csharp" 或拼错成 "jason"，IDE 直接忽略，不报错也不提示。
为什么写了 StringSyntax 却没高亮？
常见原因不是写错了，而是环境没配好：
- Visual Studio 版本低于 17.4 —— 必须升级到 VS 2022 17.4 或更新版
- 没启用关键开关：工具 → 选项 → 文本编辑器 → C# → 高级 → 勾选“增强的字符串字面量支持”
- 用了 Rider 或 VS Code（即使装了 C# Dev Kit）—— 目前仅稳定支持
"json"和"regex"，其他如"sql"、"css"可能无反应 - 字符串不是字面量：比如
string [StringSyntax("json")] json = GetFromApi();，IDE 不会处理运行时值，只对@"{""id"":1}"这类直接写的字符串起作用
StringSyntax 支持哪些语法类型？
官方明确识别的字符串类型有（大小写敏感）：
-
"json"：触发 JSON 键名/字符串/数字着色与结构提示 -
"regex"：高亮元字符（\d、*、+）、分组、断言等 -
"html"、"xml"、"css"、"sql"、"uri"、"datetime"、"guid"
其中 "datetime" 对 "yyyy-MM-dd" 类格式有基础提示，"guid" 会检查是否符合 8-4-4-4-12 格式（但不阻止你写错）。所有这些都不做编译期或运行期验证——[StringSyntax("json")] string s = "{id:1}"; 完全合法，只是 IDE 里会标红提示 JSON 错误（如果开了该功能）。
StringSyntax 和字符串安全之间没因果关系
这是最容易被误解的一点：
- 它不防止 SQL 注入：加了
[StringSyntax("sql")] string query，照样能拼接用户输入 - 它不校验正则有效性：写
[StringSyntax("regex")] string p = "[a-z+";（缺右括号），VS 可能标黄，但编译完全通过，运行时Regex构造才真正抛异常 - 它不替代
JsonSerializer.Deserialize<T>或SqlParameters—— 纯属编辑器辅助，和“安全”“健壮性”无关
真正要靠的是类型系统、参数化查询、JSON 序列化库，而不是这个属性。把它当成智能注释更准确：告诉 IDE “请按这个规则渲染”，仅此而已。
