如何用VS2019保存JSON文件:从创建到导出的完整指南
在软件开发中,JSON(JavaScript Object Notation)作为一种轻量级的数据交换格式,因其易读性和灵活性被广泛应用于配置文件、数据存储、API交互等场景,Visual Studio 2019(简称VS2019)作为主流的开发工具,提供了多种便捷的JSON操作方式,本文将详细介绍如何在VS2019中创建、编辑并保存JSON文件,涵盖不同场景下的操作步骤和注意事项。
直接创建并保存JSON文件
对于简单的JSON文件需求(如配置文件、测试数据等),最直接的方式是在VS2019中新建一个文本文件并手动编辑,然后保存为JSON格式,以下是具体步骤:
新建JSON文件
- 打开VS2019,选择顶部菜单栏的 文件 → 新建 → 文件(或按快捷键
Ctrl+N)。 - 在弹出的 新建文件 窗口中,选择 “常规” 分类下的 “JSON 文件”(如果未找到,可在搜索框中输入“JSON”筛选),点击 “打开”。
提示:如果VS2019未默认显示“JSON文件”选项,可能需要安装JSON相关的工作负载,可通过 工具 → 获取工具和功能 → 修改,在 “Web和云” 工作负载中勾选 “ASP.NET和Web开发”(该工作负载包含JSON支持组件)。
编辑JSON内容
新建的JSON文件会自动填充默认模板(如简单的或[]),此时可直接编辑内容,创建一个存储用户信息的JSON文件:
{
"users": [
{
"id": 1,
"name": "张三",
"email": "zhangsan@example.com"
},
{
"id": 2,
"name": "李四",
"email": "lisi@example.com"
}
]
}
保存为JSON格式
- 编辑完成后,按快捷键
Ctrl+S保存文件,或点击顶部菜单栏的 文件 → 保存。 - 在 “另存为” 窗口中,选择保存位置,然后在 “文件名” 框中输入文件名(如
users.json),“保存类型” 选择 *“JSON 文件(.json)”,最后点击 “保存”**。
注意:文件扩展名必须为
.json,否则VS2019可能无法正确识别文件类型,导致语法高亮、智能提示等功能失效。
通过代码动态生成并保存JSON
在实际开发中,JSON数据通常由程序动态生成(如从数据库查询结果、API响应等),此时可通过代码将对象或数据序列化为JSON字符串,并保存到文件,以下是不同语言的实现方式:
C#中使用System.Text.Json(.NET Core 3.0+/.NET 5+)
.NET Core 3.0及以上版本内置了System.Text.Json命名空间,无需额外安装包,以下示例将一个用户对象列表序列化为JSON并保存:
using System;
using System.Collections.Generic;
using System.Text.Json;
using System.IO;
class Program
{
static void Main()
{
// 1. 准备数据(模拟从数据库或其他来源获取)
var users = new List<User>
{
new User { Id = 1, Name = "张三", Email = "zhangsan@example.com" },
new User { Id = 2, Name = "李四", Email = "lisi@example.com" }
};
// 2. 序列化为JSON字符串(格式化输出,缩进为2个空格)
var options = new JsonSerializerOptions { WriteIndented = true };
string jsonString = JsonSerializer.Serialize(users, options);
// 3. 保存到文件(指定路径为当前项目的bin/Debug目录)
string filePath = Path.Combine(AppContext.BaseDirectory, "users.json");
File.WriteAllText(filePath, jsonString);
Console.WriteLine($"JSON文件已保存至: {filePath}");
}
}
// 用户模型类
public class User
{
public int Id { get; set; }
public string Name { get; set; }
public string Email { get; set; }
}
操作步骤:
- 在VS2019中创建一个控制台应用(.NET Core)或控制台应用(.NET Framework)项目(.NET Framework需通过NuGet安装
System.Text.Json包:右键项目 → 管理NuGet程序包 → 搜索System.Text.Json→ 安装)。 - 将上述代码粘贴到
Program.cs中,按F5运行,程序会在bin/Debug/netX.0目录下生成users.json文件。
使用Newtonsoft.Json(.NET Framework/旧版.NET Core)
如果项目使用.NET Framework或旧版.NET Core,可安装流行的第三方库Newtonsoft.Json(Json.NET),示例代码如下:
using System;
using System.Collections.Generic;
using Newtonsoft.Json;
using System.IO;
class Program
{
static void Main()
{
var users = new List<User>
{
new User { Id = 1, Name = "王五", Email = "wangwu@example.com" }
};
// 序列化为JSON字符串(格式化)
string jsonString = JsonConvert.SerializeObject(users, Formatting.Indented);
// 保存到文件
string filePath = "users_newtonsoft.json";
File.WriteAllText(filePath, jsonString);
Console.WriteLine($"JSON文件已保存至: {filePath}");
}
}
public class User
{
public int Id { get; set; }
public string Name { get; set; }
public string Email { get; set; }
}
操作步骤:
- 右键项目 → 管理NuGet程序包 → 搜索
Newtonsoft.Json→ 安装最新版本。 - 编写代码并运行,即可生成JSON文件。
JavaScript/TypeScript(Node.js环境)
如果使用VS2019开发Node.js项目,可通过JSON.stringify()和fs模块保存JSON文件:
const fs = require('fs');
// 准备数据
const users = [
{ id: 1, name: "赵六", email: "zhaoliu@example.com" },
{ id: 2, name: "钱七", email: "qianqi@example.com" }
];
// 序列化为JSON字符串(格式化)
const jsonString = JSON.stringify(users, null, 2);
// 保存到文件(同步方式)
fs.writeFileSync('users_js.json', jsonString, 'utf8');
console.log('JSON文件已保存: users_js.json');
操作步骤:
- 在VS2019中创建Node.js.js项目(安装Node.js和必要的包)。
- 将代码粘贴到
index.js中,通过终端运行node index.js生成文件。
使用VS2019插件辅助保存JSON
对于复杂的JSON结构(如嵌套层级深、需格式化或验证),可借助VS2019插件提升效率,推荐插件:
“JSON Tools”插件
- 功能:提供JSON格式化、压缩、验证、转义/反转义等功能,支持批量处理。
- 安装:点击顶部菜单栏 工具 → 扩展和更新 → 在线搜索“JSON Tools” → 点击 “下载” 并重启VS2019。
- 使用:编辑JSON文件后,右键编辑区 → 选择 “Format JSON”(格式化JSON),或通过快捷键
Ctrl+K Ctrl+F(需先选中内容)自动格式化。
“Prettier - Code Formatter”插件
- 功能:支持多种语言(包括JSON)的代码格式化,可自定义缩进、引号等规则。
- 安装:同上,搜索“Prettier”并安装。
- 使用:右键JSON文件 → “Format Document With...” → 选择“Prettier”即可一键格式化。
保存JSON时的常见问题及解决
文件编码问题
JSON文件推荐使用UTF-8编码(无BOM头),否则可能导致特殊字符(如中文)乱码。
- 解决:保存文件时,在 “另存为” 窗口点击右下角 “保存” 按钮旁边的下拉箭头,选择 “保存UTF-8”(部分VS2019版本可能需通过 “高级保存选项” 设置编码为“Unicode (UTF-8 无签名)”)。
JSON格式错误
如果JSON语法错误(如缺少逗号、大括号不匹配),保存时VS2019会通过红色波浪线提示,并在 “错误列表” 窗口(视图 → 错误列表)显示具体错误。
- 解决:根据错误



还没有评论,来说两句吧...