VSCode不支持右键新建JSON配置文件,settings.json仅识别用户级和工作区级(.vscode/settings.json)两种路径;必须通过设置界面打开JSON编辑或触发内置命令生成tasks.json等文件,手动创建同名文件将静默失效。

VSCode里根本不存在“新建JSON配置文件”这个操作
你不能像新建.txt那样右键→新建→settings.json。VSCode只认两个位置的settings.json:用户级(全局)和工作区级(项目根目录下的.vscode/settings.json),且必须由VSCode自己生成或打开——手动创建的同名文件,哪怕路径对、名字对,只要不是它亲手写进去的,一律无视。
想加一条用户级设置,就直接改用户settings.json
按 Ctrl + ,(Windows/Linux)或 Cmd + ,(macOS)打开设置界面 → 点右上角的{}图标(“Open Settings (JSON)”)→ 它会自动打开你本机的用户级settings.json(路径类似$HOME/.config/Code/User/settings.json)→ 光标放在花括号{}内部,输入一行合法键值对,比如:
"editor.fontSize": 14,
注意末尾加英文逗号(如果后面还有其他配置);保存即生效。别试图在桌面或项目根目录下另建一个settings.json丢进去——它不会被加载,也不会报错,只是静默失效。
想为某个项目单独配JSON,必须放.vscode子目录下
工作区级配置只在打开该项目文件夹时生效,且路径必须是:.vscode/settings.json(注意.vscode是隐藏文件夹,不是vscode或VSCode)。实操步骤:
- 在项目根目录下新建文件夹,命名为
.vscode(开头带点,大小写敏感) - 在该文件夹内新建文件,命名为
settings.json - 用VSCode打开这个
settings.json,确保编码是UTF-8无BOM(记事本保存会默认加BOM,导致整个文件解析失败) - 内容必须是合法JSON对象,最外层是
{},不能是数组或纯字符串
常见错误:把settings.json直接放在项目根目录(没进.vscode),或用Notepad保存成ANSI编码,或开头有不可见的(BOM字节),都会让VSCode拒绝读取。
tasks.json / launch.json / c_cpp_properties.json 这些不是“新建”,而是“触发生成”
这类文件属于项目专用配置,没有图形界面入口,也不能手写路径去创建。正确方式是触发VSCode内置命令:
-
tasks.json:菜单栏选终端 → 配置默认生成任务,或按Ctrl+Shift+P搜Tasks: Configure Task -
launch.json:点击左侧“运行和调试”图标 → 点创建 launch.json 文件→ 选环境(如Python、C++) -
c_cpp_properties.json:按Ctrl+Shift+P搜C/C++: Edit Configurations (UI),填完后它自动生成
这些命令会在.vscode下创建对应文件,并填充合理默认值。硬写一个空tasks.json放进去,VSCode不会识别,也不会报错——它只响应特定命令触发的生成逻辑。


















