ctrl+/默认只注释光标所在行，非选中区域整体；多行需先确保行选择（shift+alt+↓）或转多光标（ctrl+shift+l），且语言模式正确、无插件冲突。
Ctr+/ 不是“选中几行就注释几行”的万能键，它默认只处理光标所在行；多行批量注释必须先确保选区方式正确、语言模式识别准确，否则大概率只动第一行或完全没反应。
Ctrl+/ 为什么只注释/取消了一行？
VSCode 的 Ctrl+/（Windows/Linux）或 Cmd+/（macOS）本质是「切换当前光标所在逻辑行」的注释状态，不关心你拖选了多少行——只要光标停在第 3 行，哪怕你框选了 10 行，它也只动第 3 行。
- 鼠标拖选后按
Ctrl+/失效？说明你处于「文本选中」而非「行选中」状态；改用点击行号左侧空白，或按Shift+Alt+↓（Win/Linux）逐行扩展高亮条 - 已用鼠标框选？先按
Ctrl+Shift+L（Win/Linux）把每行转为独立光标，再按Ctrl+/ - 光标落在行尾空白处？
Ctrl+/可能插入//到行末，看起来像没生效；把光标移到任意非空白字符上重试 - 快捷键被插件劫持？打开命令面板输入
Preferences: Open Keyboard Shortcuts (JSON)，检查editor.action.commentLine是否被覆盖
Shift+Alt+A 包裹失败或吞掉下一行？
Shift+Alt+A（Win/Linux）或 Shift+Option+A（macOS）是「块注释」操作，依赖文本选区，且对换行和缩进敏感——它不是智能代码分析，而是机械地在开头插 /*、结尾加 */（或对应语言符号）。
- 选中后末尾没换行？VSCode 可能误吞下一行首字符（尤其 JSX 或 HTML 中）；建议选中前手动加个回车
- Python 文件里按了没反应？因为 Python 没原生块注释语法，
Shift+Alt+A会 fallback 为连续#行注释，或直接静默 - JSON 文件里按了没提示也没效果？JSON 标准不支持任何注释，VSCode 会跳过，不是 bug
- HTML 里生成了奇怪符号？确认右下角 language mode 是
html而非plaintext或javascript
为什么 .tsx 或 .sh 文件注释符号不生效？
VSCode 注释行为由 languageId 决定，不是文件后缀。比如 .tsx 默认可能是 typescript，但只有 typescriptreact 才支持 JSX 内部的 {/* */}；.sh 若被识别为 plaintext，# 注释就不会触发。
- 临时修复：点击右下角语言标签 → 手动选
TypeScript React或Shell Script - 永久修复：在工作区根目录
.vscode/settings.json中添加："files.associations": {"*.tsx": "typescriptreact", "*.sh": "shellscript"} - 验证是否生效：按
Ctrl+Shift+P→ 输入Developer: Inspect Editor Tokens and Scopes→ 看光标处显示的languageId是什么 - 某些嵌入式块（如
<script></script>里的 JS）需语言服务器识别上下文，仅改后缀不够
多行注释该用 Ctrl+K Ctrl+C 还是 Shift+Alt+A？
两者用途不同：Ctrl+K Ctrl+C 是「行注释批量开关」，Shift+Alt+A 是「块注释包裹/解包」。选错会导致逻辑屏蔽不干净或破坏格式。
-
Ctrl+K Ctrl+C：适合临时禁用一段完整逻辑，每行加//或#，可逐行取消；跨空行也安全 -
Shift+Alt+A：适合封装一段需要整体跳过、但又不想改变行结构的代码（如调试时绕过某段计算），但要求选区连续、末尾有换行、且语言支持块注释 - Python 不支持
/* */，Shift+Alt+A在.py文件里不会生成三引号，除非装了额外扩展 - HTML 中
Shift+Alt+A生成<!-- -->，但若选区跨标签边界（如只选中一半<div>），可能破坏结构<p>真正卡住人的从来不是快捷键记不住，而是 languageId 没对、选区方式错了、或者以为“选中=生效”却忽略了 VSCode 对「行选中」和「文本选中」的严格区分。每次失效，先看右下角，再看光标在哪，最后才查快捷键绑定。</p> </div>
