Turbo Console Log插件依赖光标精准落在变量名字母范围内才能正确识别，否则输出undefined或无响应；需手动配置快捷键与logTemplate模板以支持文件名、行号等上下文信息。
光标必须落在变量名上，否则插件“看不见”你要打什么
Turbo Console Log 不是语法分析器，它只看光标当前位置的字符是否构成合法标识符（比如 user、isLoading），然后“猜”你要打印这个变量。如果光标停在 user.name 的 name 上，它就只取 name；停在括号里、字符串中、注释内，或刚好卡在点号 . 后面，都会识别失败，输出 undefined 或空日志。
常见错误现象：console.log('name:', name); 明明想打整个对象，结果只打了属性名；按了快捷键却没反应——大概率是光标位置不对。
- 确保光标完全落在变量名字母范围内（比如
data的d、a、t、a中任意一个） - 不想靠“猜”？直接用鼠标双击或拖选整个变量名（如
response.data.items），再触发快捷键 - 函数调用如
fetchUser()会被原样执行一次——别在有副作用的调用上乱按快捷键
默认快捷键常被占用，必须手动检查并重绑
Windows/Linux 默认是 Ctrl+Alt+L，macOS 是 Cmd+Alt+L，但系统级快捷键（比如 macOS 的 Mission Control）、其他插件（如 Prettier、GitLens）或输入法极易抢占该组合键，导致插件静默失效。
实操建议：
- 打开 VSCode 设置 → 搜索
turbo console log keybinding→ 找到editor.action.turboConsoleLog - 右键该条目 → “Change Keybinding”，试设为
Ctrl+Shift+L或Cmd+Shift+L（这类组合冲突概率低） - 绑定后，可在任意 JS/TS 文件中右键菜单确认是否出现
Log the selected text/variable选项
模板配置只能写 JSON，UI 里找不到“时间戳”“文件名”开关
插件的上下文信息（如文件名、行号、时间戳）不是开箱即用的，默认只输出最简格式 console.log('var:', var);。想加 [app.js:42] 或 [2026-05-01 14:18]，必须手动编辑 settings.json。
关键配置项（复制进用户设置 JSON）：
{
"turboConsoleLog.includeFilename": true,
"turboConsoleLog.includeLineNum": true,
"turboConsoleLog.logTemplate": "console.log('[${fileName}:${lineNumber}] ${name}:', ${name});"
}
注意：${date} 和 ${time} 是插件支持的变量，但 logTemplate 必须完整覆盖整行语句，不能只填片段；若同时启用了保存时自动格式化（Prettier/ESLint），可能把生成的日志挤成一行，可临时加 // prettier-ignore 注释。
多光标批量插入可行，但每个光标都得“合法”
按住 Option（macOS）或 Alt（Windows）逐个点击多个变量名起始位置，或用 Ctrl+D 多次选中相同变量，就能一次触发全部日志插入。但这依赖每个光标都落在有效标识符内。
容易踩的坑：
- 某一个光标落在字符串里（比如
"user"引号中）→ 全部失败，不会部分生效 - 多个光标跨了不同作用域（如一个在
const a = 1，另一个在函数参数(a) => {}）→ 插件不校验作用域，只管拼字符串，可能打出未定义变量 - 批量生成后记得检查是否所有日志都带上了预期上下文，尤其当文件名含空格或特殊字符时，
${fileName}可能被截断
真正麻烦的从来不是“怎么加日志”，而是“加完之后哪条对应哪个变量、在哪执行、有没有重复触发”。Turbo Console Log 能省掉手敲，但上下文准确性、执行安全性、团队协作时的可读一致性，全得靠你盯住光标位置和模板细节。
