VSCode新建文件需带扩展名才能触发格式化，否则视为纯文本；应通过资源管理器右键、Ctrl+N保存时填扩展名或终端touch+code三种方式创建，并配置项目级.settings.json启用formatOnSave及对应默认格式化器。
VSCode 中新建文件后默认不会自动格式化，必须显式触发或配置保存时格式化，否则即使装了 Prettier、ESLint 或 clang-format，新文件内容也不会被美化。
新建文件的三种可靠方式（带扩展名是关键）
VSCode 识别语言和启用格式化的前提是文件有正确扩展名。不写 .js、.py 或 .cpp，编辑器只当它是纯文本，后续格式化功能基本失效。
- 在资源管理器中右键目标文件夹 → “新建文件”，输入完整名称如
index.html或main.py，回车确认 - 快捷键
Ctrl+N新建空白标签页，编辑完内容后按Ctrl+S，务必在弹出的保存对话框中手动输入带扩展名的文件名（如utils.ts），不能只输utils - 终端中执行
touch server.go && code server.go，确保touch创建的文件名含扩展名，否则code打开后仍无语言模式
新建即生效的格式化配置（绕过“先保存再格式化”陷阱）
很多人新建文件后按 Shift+Alt+F 没反应，是因为没激活语言服务——而语言服务依赖扩展名和已安装的对应格式化器。光装 Prettier 不管用，还得告诉 VSCode “对这类文件用它”。
- 确保已安装对应语言的格式化扩展：如
esbenp.prettier-vscode（JS/TS/HTML/CSS）、ms-python.black-formatter（Python）、llvm-vs-code-extensions.vscode-clangd或独立clang-format（C/C++） - 在工作区根目录创建
.vscode/settings.json，写入：{ "editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode", "[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }, "[typescript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }, "[python]": { "editor.defaultFormatter": "ms-python.black-formatter" } } - 不要只依赖全局设置：项目级
.vscode/settings.json优先级更高，能避免团队成员格式化行为不一致
格式化失败的典型表现和快速排查点
新建文件保存后没变化？快捷键无响应？常见原因不是插件没装，而是链路断在中间某环。
-
html.format.enabled默认为true，但如果你禁用了内置 HTML 格式器又没配替代方案，index.html就无法格式化——检查设置里是否误关了该选项 - C/C++ 文件需额外确认：
clang-format可执行文件是否在PATH中？VSCode 设置里的clang-format.executable路径是否指向真实二进制？which clang-format或clang-format --version必须在终端返回有效结果 - Python 文件若用
black，注意它默认拒绝格式化未保存的脏文件（unsaved buffer）：必须先Ctrl+S保存为.py文件，再触发格式化，否则报错black failed to format - 状态栏右下角语言标识（如“Plain Text”）没变？说明扩展名错误或文件为空白——哪怕只敲一个空格再删掉，也能强制触发语言检测
最易被忽略的一点：新建文件如果没被保存到磁盘（即仍是“Untitled-1”标签），所有基于文件路径的格式化逻辑（包括读取 .prettierrc、.clang-format、pyproject.toml）全部跳过。务必先落地为真实文件，再指望格式化生效。
