plaintasks安装后无反应是因为需手动设置语法为plain tasks或使用.task等后缀;任务行必须顶格以- [ ]、- [x]开头;@due和@priority格式须严格符合iso日期和单字母优先级;归档要求文件末尾有规范的## archive区块。

PlainTasks安装后为什么没反应?
插件装完不等于能用——PlainTasks 不会自动接管任何文件,它只在语法被设为 Plain tasks 时才激活命令和高亮。新建一个空文件,默认是 Plain text 语法,所有快捷键(Ctrl+Enter、Ctrl+Shift+T)全部失效,界面也不报错。
必须手动切换语法:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Set Syntax: Plain tasks回车 - 或者把文件后缀改成
.task、.todo、.tasks等,Sublime 通常会自动匹配(前提是插件已安装成功) - 检查
Preferences → Package Settings → PlainTasks → Settings中是否启用了"auto_set_syntax": true
任务行写法不对,列表就“消失”了
PlainTasks 只识别严格顶格、格式精准的任务行:必须以 - [ ]、- [x] 或 - [X] 开头,前面**不能有任何空格或 Tab**。哪怕只多一个空格,整行就被当作文本忽略。
-
- [ ] 买咖啡→ ✅ 有效任务 -
- [ ] 买咖啡→ ❌ 完全不识别(缩进/空格开头) -
# 今日计划→ ❌ 标题行,不参与任务逻辑,但可用作分组 - 用空行代替缩进来组织结构,别用 Tab 对齐任务项
@due 和 @priority 格式错一点就全盘失效
PlainTasks 对元数据格式零容忍。一旦写错,该行不仅失去排序/过滤能力,还可能拖累整个文件的解析行为(比如归档失败、统计不准)。
-
@due(2026-07-06)→ ✅ ISO 格式,年-月-日 -
@due(06/07/2026)→ ❌ 不识别,整行降级为普通文本 -
@priority(H)→ ✅ 高优先级(大小写敏感) -
@priority(high)→ ❌ 失效,不会标红,也不会影响排序 -
@due(2026-07-06) @priority(H) @project(work)→ ✅ 多标签共存,顺序任意,但每个都必须格式正确
归档失败却没提示?检查 ## Archive 区块是否规范
Ctrl+Shift+A 归档命令不会弹窗、不报错,但它有一个硬性前提:文件末尾必须存在且仅存在一行 ## Archive(两个井号 + 一个空格 + Archive),大小写敏感,不能有其他字符或多余空格。
-
## Archive→ ✅ 正确,归档内容将插入其下 -
##Archive或## archive或## Archive:→ ❌ 静默失败,任务不移动 - 归档前建议先手动加好该区块,再执行命令
- 时间戳乱码(如
??????)大概率是 Windows 下编码冲突,直接在 PlainTasks 设置中加"date_format": "%Y-%m-%d %H:%M"即可解决
PlainTasks 的“开箱即用”是个错觉——它真正依赖的是你写任务时的克制:顶格、不用缩进、日期用 ISO、优先级用单字母、归档区块独占一行。这些细节不处理,插件就只是个高亮器。











