Files
Sprout-Farm/Server/JsonEdit/README.md

100 lines
2.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# JSON 批量编辑器
一个简洁强大的JSON编辑工具专门用于批量添加键值对到JSON文件中的所有对象。
## 🚀 功能特点
- **批量添加属性**: 一键为JSON中所有对象添加新的键值对
- **智能类型识别**: 自动识别并转换数据类型
- **支持所有JSON数据类型**: 字符串、数字、布尔值、对象、数组、null
- **文件上传**: 支持JSON文件拖拽上传
- **即时下载**: 编辑完成后立即下载修改后的JSON文件
- **无需服务器**: 纯前端实现,直接在浏览器中运行
## 📋 支持的数据类型
| 类型 | 输入示例 | 转换结果 |
|------|----------|----------|
| 字符串 | `hello world` | `"hello world"` |
| 整数 | `123` | `123` |
| 小数 | `3.14` | `3.14` |
| 布尔值 | `true``false` | `true``false` |
| 空值 | `null` | `null` |
| 对象 | `{"key": "value"}` | `{"key": "value"}` |
| 数组 | `[1, 2, 3]` | `[1, 2, 3]` |
| 空字符串 | *(留空)* | `""` |
## 🎯 使用方法
### 1. 加载JSON数据
- **方法一**: 点击"上传JSON文件"按钮选择文件
- **方法二**: 直接在编辑器中粘贴JSON数据
- **方法三**: 点击"加载示例数据"使用预设数据
### 2. 批量添加属性
1. 在"键名"字段输入要添加的属性名,如: `能否购买`
2. 在"键值"字段输入属性值,如: `true`
3. 点击"批量添加到所有对象"按钮
4. 系统会自动为JSON中的每个对象添加该属性
### 3. 下载结果
点击"下载修改后的JSON"按钮保存编辑后的文件
## 💡 使用示例
### 原始JSON:
```json
{
"小麦": {
"花费": 120,
"收益": 100,
"品质": "普通"
},
"稻谷": {
"花费": 100,
"收益": 120,
"品质": "普通"
}
}
```
### 添加属性: 键名=`能否购买`, 键值=`true`
### 结果JSON:
```json
{
"小麦": {
"花费": 120,
"收益": 100,
"品质": "普通",
"能否购买": true
},
"稻谷": {
"花费": 100,
"收益": 120,
"品质": "普通",
"能否购买": true
}
}
```
## 🔧 快速开始
1. 直接在浏览器中打开 `templates/json_editor.html` 文件
2. 无需安装任何依赖或服务器
3. 开始使用批量编辑功能
## ⚠️ 注意事项
- 工具会递归处理嵌套对象,为所有找到的对象添加指定属性
- 数组元素如果是对象,也会被添加属性
- 确保JSON格式正确否则无法处理
- 修改前建议备份原始文件
## 🎨 界面说明
- **左侧边栏**: 文件操作、批量编辑功能、快速示例
- **右侧编辑区**: JSON数据显示和编辑
- **智能提示**: 实时显示操作结果和错误信息
这个工具特别适合游戏开发、配置文件管理等需要批量修改JSON数据的场景。