<p>PlainTasks 插件无响应首要检查文件类型是否设为PlainTasks,并确认任务格式为“- 空格文本”“- x 空格文本”等标准语法,日期与优先级须用Ctrl+Alt+T/P快捷键生成,过滤需在PlainTasks语法文件中用Ctrl+Shift+R调出。</p>

PlainTasks 插件装完没反应?检查是否启用并关联文件类型
装完 PlainTasks 后新建 .txt 文件,按 Ctrl+Shift+P(Win/Linux)或 Cmd+Shift+P(macOS)调出命令面板,输入 PlainTasks: Toggle task 没反应,大概率是插件没激活或文件没被识别为任务文件。
- 确保已执行过
Package Control: Install Package→ 输入PlainTasks并回车安装成功(重启 Sublime 不是必须,但建议) - 新建文件后,右下角状态栏看文件类型是否显示为
PlainTasks;如果不是,点它 → 选Open all with current extension as… → PlainTasks - 更稳妥的做法:把文件保存为
TODO.md或tasks.pt,插件会自动匹配.pt、.todo、.md(部分版本支持)等后缀 - 如果仍不生效,检查
Preferences → Package Settings → PlainTasks → Settings是否有误删了"syntax": "Packages/PlainTasks/PlainTasks.sublime-syntax"这类关键配置
任务标记写法不对,勾选/折叠全失效
PlainTasks 不认随意写的 - [x] 或 ✅ done,它只解析特定前缀 + 空格 + 文本的组合。格式错一个空格,就变普通文本,无法交互。
- 待办任务必须以
-(短横+空格)开头,例如:- 买咖啡 - 已完成任务用
x(小写 x + 空格)或X(大写 X + 空格),例如:- x 买咖啡或- X 买咖啡 - 取消任务用
~(波浪号+空格),例如:- ~ 买咖啡(改期) - 不要手动打
[ ]或[x]—— 这是 Markdown 风格,PlainTasks不解析;快捷键Ctrl+Enter(Win/Linux)或Cmd+Enter(macOS)才是正确切换方式 - 子任务需缩进 2 或 4 个空格(取决于设置),且缩进后仍需保持上述前缀格式
日期和优先级怎么加?别手敲,用快捷键生成
手动输 @today 或 @priority:H 容易拼错、漏冒号、大小写不一致,导致过滤/排序失效。插件内置快捷键能保证语法准确,还能自动补全常用值。
- 插入当前日期:光标放在任务行末尾,按
Ctrl+Alt+T(Win/Linux)或Cmd+Alt+T(macOS),自动生成@due(2024-06-12)或@created(2024-06-12) - 加优先级:光标在任务行任意位置,按
Ctrl+Alt+P(Win/Linux)或Cmd+Alt+P(macOS),会弹出选项让你选H(high)、M(medium)、L(low),自动插入@priority:H - 所有时间标签(
@due、@started、@done)都支持相对写法,比如@due(tomorrow)、@due(in 3 days),但前提是你的PlainTasks版本 ≥ 2.0.0(旧版只认绝对日期) - 注意:标签必须紧贴任务文字末尾,中间不能有空行或多余空格,否则解析失败
过滤和视图切换总失败?确认语法和作用域范围
想用 @today 筛出今日任务,结果啥都不显示,常见原因是过滤命令没对准当前文件,或用了不支持的语法。
- 过滤操作必须在 PlainTasks 语法激活的文件里进行:先确认右下角显示的是
PlainTasks,不是Markdown或Plain Text - 调出过滤面板用
Ctrl+Shift+R(Win/Linux)或Cmd+Shift+R(macOS),输入@today回车 —— 不是搜索框(Ctrl+F),也不是命令面板(Ctrl+Shift+P) -
@today只匹配@due(today)或@due(2024-06-12),不匹配@created(today);如需按创建时间过滤,得用@created标签+对应语法 - 折叠/展开全部任务用
Ctrl+K Ctrl+1(折叠)和Ctrl+K Ctrl+2(展开),不是Ctrl+Shift+[那套通用折叠键,后者对 PlainTasks 无效
事情说清了就结束。最常卡住的地方其实是文件类型没设对,以及手动敲标签时多了一个空格、少了一个括号——这些细节不报错,但功能直接静默失效。

















