针对轻量级项目的VSCode快速纠错规则配置-VSCode-PHP中文网

轻量级项目应精简检查链路，优先关闭干扰项：禁用detectindentation、按语言限制诊断范围、cspell仅检查comments/strings、确保quick fix快捷键可用且语言模式正确。

针对轻量级项目的vscode快速纠错规则配置

轻量级项目不需要堆砌整套 ESLint + Prettier + TypeScript Server 的检查链路，VSCode 自带的 cSpell、editor.quickSuggestions 和语言服务器基础诊断已足够覆盖 90% 的拼写、语法和符号错误。关键不是“开更多检查”，而是关掉干扰项、对齐配置优先级、避免规则打架。

关掉 detectIndentation 和自动格式化冲突

轻量级项目常因缩进混乱被误报“语法错误”（比如 Python 报 IndentationError，但实际是 VSCode 错把 Tab 当空格）。根源常在 editor.detectIndentation 自动猜错，或 editor.formatOnSave 被未配置的 formatter 触发乱排。

在项目根目录 .vscode/settings.json 中强制关闭检测："editor.detectIndentation": false
统一缩进风格："editor.insertSpaces": true + "editor.tabSize": 2（JavaScript/TypeScript/Markdown 推荐）或 4（Python）
禁用未启用 formatter 的自动格式："editor.formatOnSave": false，除非你明确装了 esbenp.prettier-vscode 并设为默认

只启用必要语言服务器诊断

VSCode 默认对所有打开的文件启用语言服务器，但轻量项目往往混着 .js、.md、.json，而 jsonc 服务会对 .json 做严格 schema 校验，导致误报（如 package.json 缺少 type 字段被标红）。

VSCode

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

下载

按语言粒度开关诊断：在 settings.json 中用语言专属块限制范围，例如：
```
{"[json]": {"editor.quickSuggestions": false,"json.schemas": []}}
```
禁用非当前项目语言的 server：比如纯 JS 项目，关掉 python、rust 相关扩展的后台服务（通过扩展面板右键 → Disable (Workspace)）
对 .md 文件，保留 editor.quickSuggestions 但关掉 markdown.preview.breaks 类易误触发项

拼写检查只扫注释与字符串，不碰代码标识符

cSpell 默认会检查变量名、函数名，这在轻量项目里毫无意义——myVarName 拼错不会影响运行，但会淹没真正该修的注释拼写错误（如 "recieve"）。

在项目级 cspell.json 中设置："languageSettings": [{"language": "javascript","enableFiletypes": ["comments", "strings"]}]
添加常用缩写进 words 列表，避免误报："words": ["http", "url", "jsx", "ts"]
用 ignoreWords 过滤无意义词："ignoreWords": ["todo", "fixme", "hack"]（注意全小写，匹配默认行为）