text power tools 必须手动启用才能使用全部功能，执行 text power tools: toggle enabled 后状态栏右下角出现蓝色 tp 图标即为激活；未启用则命令静默失效，且设置不跨工作区保存。

Text Power Tools 不是开箱即用的“一键生效”工具，它必须手动启用才能调用全部功能；没执行 Text Power Tools: Toggle Enabled，所有命令都会静默失败或根本不出现在命令面板里。

怎么确认 Text Power Tools 已真正启用

很多人卡在这一步：装完扩展、重启 VSCode、打开命令面板搜“Convert Case”，结果什么都没——因为没启用。这不是 Bug，是设计机制。

• 必须先按 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows/Linux），输入并执行 Text Power Tools: Toggle Enabled
• 执行后状态栏右下角会出现一个微小的 TP 图标，且颜色变蓝，才表示已激活
• 若图标为灰色或不显示，说明仍处于禁用状态，后续所有功能均不可用
• 该设置不跨工作区保存，换一个文件夹打开项目时，可能需重新启用一次

批量加行号别用 Text Power Tools，改用 Increment Selection

Text Power Tools 没有原生行号生成功能。强行用它的 Replace with Regex 模拟编号（比如用 ^ 匹配行首再替换为 1. ）只能写死数字，无法自动递增。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 正确做法是安装 Increment Selection 插件，然后：
  • 用 Ctrl+Alt+↑/↓（Windows/Linux）或 Cmd+Option+↑/↓（macOS）选中多行首列
  • 再按 Ctrl+Alt+I（Win/Linux）或 Cmd+Option+I（macOS），光标会逐行生成递增数字
• 如果已有文本块需要插入序号（如日志条目），先用列选择选中所有行首空白处，再触发 Increment Selection，比正则更稳、更可控
• 注意：该插件对空行和缩进敏感，若某行开头有空格或制表符，光标可能落在错误列，建议先统一清理行首空白

正则替换跨行失败？检查是否开了 “dot matches newline”

Text Power Tools: Replace with Regex 默认不开启跨行匹配。写 .* 只能匹配单行内任意字符，遇到换行就停住——这是最常被忽略的兼容性坑。

• 在弹出的正则输入框右侧，有个小图标（.* 或 ），点击它可切换“点号是否匹配换行符”
• 要匹配多行内容（如把 JSON 数组每个对象包一层 item:），必须开启此项，否则正则永远只扫第一行
• 开启后性能略降，大文件（>10MB）慎用；小范围操作（
• 捕获组引用仍用 $1、$2，语法与 VSCode 原生查找一致，无需额外学习

Align Lines 对齐失效？关键在分隔符输入方式

对齐不是靠“猜”，而是靠你输入的那个字符或字符串是否真实存在于每行中——且位置不能太靠后，否则对齐线会偏移甚至崩溃。

• 选中多行后执行 Text Power Tools: Align Lines，弹出输入框时：
  • 输 = → 所有行首个 = 左侧内容左对齐，右侧右对齐（适合键值对）
  • 输 （一个空格）→ 按每行第一个空格位置对齐（适合参数列表）
  • 输 \t → 实际要输入 字符，不是字面量，VSCode 会自动转义
• 若某行不含该字符，该行将被跳过，不参与对齐——不是 bug，是设计逻辑
• 想对齐冒号但有些行是 :、有些是 ：（中文冒号），得先统一替换，再对齐

Text Power Tools 的能力边界很清晰：它不做智能推断，只做你明确指定的机械操作。真正容易出错的，从来不是功能本身，而是启用状态、正则开关、对齐依据这些“默认关闭”的开关——它们藏得深，又不报错，只默默不干活。