vscode json

从 “什么是 JSON” → “VSCode 里哪些 JSON 文件” → “如何修改与运用”

🧩 一、什么是 JSON？

JSON（JavaScript Object Notation）是一种数据表示格式，全名是：

JavaScript 对象表示法

但它与语言无关，现在广泛用于配置、数据交换、API通信等。

✅ 一句话理解：

JSON 是一种用 {} 表示对象、用 [] 表示数组、用 "key": "value" 表示键值对的配置文件格式。

---

🔹 基本语法结构：

{"name": "Tom","age": 25,"skills": ["C", "Python", "Linux"],"married": false,"address": {"city": "Shenzhen","zip": "518000"}
}

• {}：包裹一个对象（类似结构体）
• []：数组
• "key"：字符串类型的键名
• :：键与值的分隔符
• 值可以是：字符串、数字、布尔、对象、数组或 null
• 不能有注释（标准 JSON 不允许 // 或 /* */）

---

🔍 JSON 的语法规则：

特性	说明
键必须用双引号包裹 "key"	单引号 'key' 会报错
最后一项后不能有逗号	JSON 不支持“尾逗号”
支持嵌套	对象内可以嵌套对象或数组
值类型	string, number, object, array, boolean, null

类型	举例	说明
对象（object）	{ "a": 1, "b": 2 }	一组键值对，用花括号包起来
数组（array）	[1, 2, 3]	有序数据列表
字符串（string）	"hello"	必须用 双引号，不能用单引号
数字（number）	123, 3.14, -10	不用引号
布尔值（boolean）	true, false	小写（和 JS/Python 一致）
空值（null）	null	表示“无”或“空”

错误	原因	正确写法
❌ 用单引号 'key'	JSON 只支持双引号	✅ "key"
❌ 最后一项后多逗号	结尾不能多 ,	✅ 删除最后一个逗号
❌ 有注释 //	JSON 不支持注释	✅ 删除注释
❌ 数字带前导零	0123 不合法	✅ 123

---

⚙️ 二、VS Code 中常见的 JSON 配置文件

当你写 C/C++ 时，VSCode 其实在后台靠这些 JSON 文件来帮你：

🧱 1️⃣ c_cpp_properties.json

定义 编译器路径、标准、头文件搜索路径、宏定义 等。

路径：

.vscode/c_cpp_properties.json

示例：

{"configurations": [{"name": "Linux","includePath": ["${workspaceFolder}/**","/usr/include","/usr/local/include"],"defines": ["DEBUG","VERSION=1.0"],"compilerPath": "/usr/bin/gcc","cStandard": "c11","cppStandard": "c++17","intelliSenseMode": "gcc-x64"}],"version": 4
}

🔹 功能说明：

字段	说明
includePath	编译器搜索头文件的路径
defines	预定义宏，相当于 #define DEBUG
compilerPath	指定编译器（如 gcc）路径
cStandard	C语言标准：c89/c99/c11
intelliSenseMode	智能提示模式，指定编译器架构

---

🧱 2️⃣ tasks.json

定义 如何编译、构建 程序。
比如执行 gcc main.c -o main 这类命令。

路径：

.vscode/tasks.json

示例：

{"version": "2.0.0","tasks": [{"label": "build C program","type": "shell","command": "gcc","args": ["main.c","-o","main","-Wall","-g"],"group": {"kind": "build","isDefault": true},"problemMatcher": ["$gcc"]}]
}

🔹 功能说明：

字段	说明
label	任务名，会显示在命令面板
type	shell 或 process，决定用哪种执行方式
command	执行的命令（比如 gcc）
args	命令行参数
group	任务分组，如构建(build)或测试(test)
problemMatcher	错误信息解析规则（常用 $gcc）

执行方式：

VSCode 中按 Ctrl+Shift+B 自动执行这个构建任务。

---

🧱 3️⃣ launch.json

定义 如何运行 / 调试 程序（配合 gdb）。

路径：

.vscode/launch.json

示例：

{"version": "0.2.0","configurations": [{"name": "Debug C program","type": "cppdbg","request": "launch","program": "${workspaceFolder}/main","args": [],"stopAtEntry": false,"cwd": "${workspaceFolder}","environment": [],"externalConsole": true,"MIMode": "gdb","miDebuggerPath": "/usr/bin/gdb","preLaunchTask": "build C program"}]
}

🔹 功能说明：

字段	作用
program	要运行的可执行文件路径
args	程序运行时的参数
cwd	工作目录
externalConsole	是否弹出终端运行
MIMode	调试器类型（gdb / lldb）
miDebuggerPath	调试器路径
preLaunchTask	调试前先执行的任务（如编译）

---

🧱 4️⃣ settings.json

定义编辑器的行为，比如缩进、字体、CMake配置、编译器提示等。

路径：

.vscode/settings.json

示例：

{"editor.tabSize": 4,"editor.insertSpaces": true,"files.associations": {"*.h": "c"},"C_Cpp.default.configurationProvider": "ms-vscode.cmake-tools"
}

---

🧠 三、VSCode 中 JSON 的变量与替换规则

VSCode 的 JSON 文件中可以用 ${变量} 表示动态路径：

变量名	含义
${workspaceFolder}	当前打开的工程根目录
${file}	当前编辑的文件路径
${fileDirname}	当前文件所在目录
${fileBasename}	文件名（不带路径）
${fileBasenameNoExtension}	文件名（不带扩展名）

例：

"command": "gcc",
"args": ["${file}","-o","${fileDirname}/${fileBasenameNoExtension}"
]

相当于执行：

gcc main.c -o ./main

---

🧩 四、自己修改与应用的技巧

1. 找规律：JSON 文件其实就是把命令写成键值对形式；

2. 不会写就用 GUI：

   • 按 Ctrl+Shift+P → 搜索 “C/C++: Edit Configurations (UI)”；
   • 它会自动生成并修改 c_cpp_properties.json；

3. 调试时先保证 tasks.json 可用；
   调试器（launch.json）依赖编译任务；

4. 改错了 JSON 文件怎么办？
   VSCode 自带语法检查，会在红色波浪线处显示错误；

5. 善用变量替换，避免硬编码绝对路径；

6. 注意 JSON 不能有注释！
   如果想写说明，可以加 _note 字段，例如：

   "_note": "用于构建 ARM 交叉编译版本"
   

---

🧱 五、一个完整 VSCode + C 的配置示例

假设工程结构如下：

project/
├── main.c
└── .vscode/├── tasks.json├── launch.json├── c_cpp_properties.json

你可以这样配置：

🧩 .vscode/c_cpp_properties.json

{"configurations": [{"name": "Linux","includePath": ["${workspaceFolder}/**"],"compilerPath": "/usr/bin/gcc","cStandard": "c11","intelliSenseMode": "gcc-x64"}],"version": 4
}

🧩 .vscode/tasks.json

{"version": "2.0.0","tasks": [{"label": "build","type": "shell","command": "gcc","args": ["main.c","-o","main","-g"],"group": { "kind": "build", "isDefault": true }}]
}

🧩 .vscode/launch.json

{"version": "0.2.0","configurations": [{"name": "Debug","type": "cppdbg","request": "launch","program": "${workspaceFolder}/main","args": [],"cwd": "${workspaceFolder}","stopAtEntry": false,"externalConsole": true,"MIMode": "gdb","miDebuggerPath": "/usr/bin/gdb","preLaunchTask": "build"}]
}

现在：

• Ctrl+Shift+B → 编译；
• F5 → 调试；
• 你就完全掌握了从源码到调试的 VSCode 自动化流程。

---

✅ 总结一张图：

文件名	作用	关键字段
c_cpp_properties.json	配置 IntelliSense、头文件、宏、标准	includePath, defines
tasks.json	编译任务定义	command, args
launch.json	运行/调试配置	program, preLaunchTask
settings.json	编辑器行为	editor., C_Cpp.

---