根本原因是VSCode未识别文件语言上下文，如.js文件需设为JavaScript React模式；右下角点击语言标签→配置文件关联为javascriptreact，并在.vscode/settings.json中添加"files.associations": {"*.js":"javascriptreact"}。
Ctrl+/ 注释失效或注释错位怎么办
根本原因不是快捷键坏了，而是 VSCode 没识别出当前文件的语言上下文。比如 .js 文件默认是 JavaScript 模式，但 React JSX 里有 {} 和组件标签，纯 JS 注释规则会把它当普通表达式处理，结果在 return ( 后面加 //，直接破坏 JSX 结构。
- 右下角状态栏确认语言模式显示为
JavaScript React，不是JavaScript或Plain Text - 点它 → 选
Configure File Association for '.js'→ 设为javascriptreact - 项目根目录加
.vscode/settings.json，写入："files.associations": {"*.js":"javascriptreact"} -
.jsx文件通常默认正确；.tsx需确保装了 TypeScript + React 支持插件
Shift+Alt+F 格式化后注释被移位或消失
这不是格式化器“乱来”，而是不同工具对注释的处理策略完全不同：Prettier 主动忽略注释位置，Clang-Format 可对齐但只限 C/C++ 的单行 // 注释，而 VSCode 内置 JS 格式器干脆不碰注释。
- JS/TS 项目用 Prettier，就别指望它对齐
//—— 它的设计原则就是“不控制注释位置” - 真要对齐 C/C++ 的行尾注释，必须装
C/C++（Microsoft）和Clang-Format（xaver.clang-format）两个扩展 - 在
settings.json里加："C_Cpp.clang_format_fallbackStyle": "{AlignTrailingComments: true, ColumnLimit: 0}" -
ColumnLimit: 0是关键，否则 clang-format 一见长行就放弃对齐逻辑
怎么只格式化选中的代码块而不是整个文件
快捷键本身支持，但行为取决于当前语言和所用格式化器是否实现“range formatting”。Prettier、Black、gofmt 都支持，但部分轻量插件可能只响应全文件格式化。
- 选中代码 → 按
Ctrl+K Ctrl+F（Windows/Linux）或Cmd+K Cmd+F（macOS） - 若无效，打开命令面板
Ctrl+Shift+P→ 输入Format Selection With→ 手动选格式化器 - 确保设置了
"editor.formatOnSelection": true，否则某些插件默认不启用该功能 - 注意：JSX 中选中一段含开闭标签的结构，Prettier 会保持语义完整重排，不会切断标签
保存时自动格式化却把变量名改小写了
这不是格式化干的，是 ESLint 或 TypeScript 在“顺手修语义”。比如你写了 myComponent，但类型定义要求首字母大写，source.fixAll.eslint 就会把它改成 MyComponent —— 这属于代码修复（code action），不是格式化（formatting）。
- 检查设置里是否开了
"editor.codeActionsOnSave": {"source.fixAll.eslint": true} - 关掉它，或只保留
"source.organizeImports"这类安全操作 - 更细粒度控制：在
.eslintrc.js里禁用易误伤的规则，如react/display-name或@typescript-eslint/naming-convention - 记住：格式化器（Prettier）只管空格缩进换行；修复器（ESLint）才管命名和类型——两者职责不能混
