<p>PlainTasks 需手动设置语法为 Plain tasks、任务行顶格书写、标签用 Tab 补全、归档需严格 ## Archive 格式，任一环节出错则功能静默失效。</p>
PlainTasks 不是装完就能用的插件，它只在你写对格式、设对语法、按对快捷键时才响应——错一个环节，所有功能静默失效。
PlainTasks 语法必须手动设置，否则 Ctrl+Enter 新建任务完全没反应
新建文件默认是 Plain Text 语法，PlainTasks 命令根本不会加载。它只在当前视图语法为 Plain tasks 时才激活：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Set Syntax: Plain tasks并回车 - 或者把文件后缀改成
.todo、.tasks、.todolist或直接命名为TODO（全大写、无点）——Sublime 才可能自动匹配 - 检查
Preferences → Package Settings → PlainTasks → Settings中是否启用了"auto_set_syntax": true，但别依赖它：手动设最稳 - 右下角显示
Plain Text就说明还没生效；变成Plain tasks才算真正启动
任务行必须顶格写，缩进或空格前缀会让 - [ ] 完全被忽略
PlainTasks 只识别严格顶格（即行首第一个字符就是 -）的任务标记：
-
- [ ] 买咖啡→ ✅ 生效 -
- [ ] 买咖啡（前面两个空格）→ ❌ 完全不识别，快捷键无效 -
\t- [ ] 买咖啡（Tab 开头）→ ❌ 同样失效，哪怕内容一模一样 - 项目标题用冒号结尾：
工作任务:，也必须顶格，且不能带- [ ] - 想分组？用空行，别用缩进——缩进只用于视觉整理，PlainTasks 不解析结构层级
Ctrl+D 没反应？先确认光标位置、文件只读状态和快捷键冲突
标记完成/取消的快捷键 Ctrl+D（Win/Linux）或 Cmd+D（macOS）失效，90% 是以下原因：
- 光标不在任务行上：必须落在以
- [ ]、- [x]或- [X]开头的行内，不能在中间文字或空格处 - 文件处于只读模式：右下角显示
RO，需执行File → Reload File with Encoding → UTF-8或检查磁盘权限 - 快捷键被劫持：比如
GitGutter、SideBarEnhancements等插件可能覆盖了Ctrl+D，查Preferences → Key Bindings – User是否有冲突规则 - 别和
Alt+C（取消任务）混淆：Windows 上Ctrl+C是复制，Alt+C才是取消任务
@due 和 @priority 必须用 Tab 补全，手敲格式错一点就整个标签失效
PlainTasks 对标签格式极其敏感，自由输入几乎必然失败：
- 输入
d再按Tab→ 插入@due()，光标停在括号里，再输+3d才生成有效截止时间 -
@due(2024-06-15)→ ✅ ISO 格式才识别；@due(15/06/2024)→ ❌ 整行任务失去排序能力 -
h+Tab→@high；@priority(high)或@priority(medium)→ ❌ 大小写敏感且只认H/M/L - 多个标签顺序不限：
- [ ] 写报告 @due(2024-06-15) @high @work→ ✅ 全部生效 - 过滤命令如
PlainTasks: Filter by @work只在标签正确前提下返回结果；格式错，就“查不到”，不是没匹配到，而是压根没解析
最容易被忽略的点：归档命令 Ctrl+Shift+A 要求文档底部存在严格格式的 ## Archive 区块——两个井号后必须紧跟一个空格，且该行不能含其他字符，否则静默失败，不报错也不移动任何内容。
