❓ 常见问题

ForJSON 使用中的常见疑问解答

🔍 基础使用

Q1: ForJSON 需要注册才能使用吗？
不需要。访客模式即可使用所有核心功能（格式化、转换、对比、工具集），但 AI 功能和 Mock API 发布有额度限制：
  • 访客：每日 5 次 AI 调用
  • 注册用户：每日 20 次 AI 调用
  • 邀请好友：永久 +10 次额度（被邀请人首日额度翻倍）
Q2: 支持的 JSON 文件最大多少？
硬限制 10MB。超过该大小的文件无法解析。对于超大文件，建议：
  1. 使用命令行工具（如 jq）预处理
  2. 拆分为多个小文件后分别处理
  3. 只提取需要的部分到 ForJSON 编辑
Q3: 编辑的数据会保存到云端吗？
不会。ForJSON 采用"本地优先"策略：
  • 编辑器操作完全在浏览器本地执行，数据不上传服务器
  • 草稿自动保存到浏览器 localStorage（刷新不丢失）
  • 仅 AI 功能和 Mock API 发布会上传数据，且 AI 会自动脱敏敏感信息
Q4: 如何快速格式化混乱的 JSON？
  1. 粘贴 JSON 到左侧编辑器
  2. 点击工具栏 格式化 按钮（或按 Ctrl+Shift+F）
  3. 如有语法错误，点击 自动修复 一键修复常见问题

🤖 AI 功能

Q5: AI 助手能做什么？
AI 助手可以通过自然语言编辑 JSON，例如：
  • "添加一个 age 字段，值为 25"
  • "删除所有 null 值"
  • "将价格字段从字符串转为数字"
  • "把用户数组按年龄排序"
  • "提取所有邮箱地址"
注意：AI 仅返回纯 JSON，不支持复杂逻辑编程或数据分析。
Q6: AI 会泄露我的敏感信息吗？
不会。ForJSON 在发送给 LLM 前会自动脱敏：
  • 手机号 → [PII_MASKED]
  • 身份证号 → [PII_MASKED]
  • 邮箱地址 → [PII_MASKED]
此外，AI 上下文限制为前 8000 字符，超长 JSON 会自动截断。
Q7: AI 额度如何重置？
  • 访客额度：每日 0:00（UTC+8）重置为 5 次
  • 用户额度：每日 0:00（UTC+8）重置为 20 次
  • 邀请加成：永久生效，不参与每日重置（如基础 20 + 邀请 10 = 30 次/天）

🔄 格式转换

Q8: 支持哪些格式转换？
支持以下格式的双向转换：
  • JSON ↔ YAML
  • JSON ↔ TOML
  • JSON ↔ CSV（对象数组）
  • JSON ↔ XML
  • JSON ↔ NDJSON（每行一个 JSON）
Q9: 为什么 JSON 转 CSV 失败？
CSV 转换要求 JSON 是对象数组格式，例如： 
[
  { "name": "Alice", "age": 30 },
  { "name": "Bob", "age": 25 }
]
单个对象或嵌套结构无法直接转 CSV，需先展平为数组。

📡 Mock API

Q10: Mock API 如何使用？
  1. 在编辑器中准备 Mock 数据（必须是合法 JSON）
  2. 点击工具栏 发布 Mock API
  3. 选择过期时间（1/2/3/5/7/24 小时）
  4. 点击 发布，系统生成唯一 URL（如 https://forjson.com/mock/abc123）
  5. 使用 curl 或浏览器访问该 URL，返回你发布的 JSON
注意：
  • 发布消耗 1 次 AI 额度
  • 每个账号最多同时保持 10 个端点
  • 过期后自动删除，无法恢复
Q11: Mock API 支持 POST 请求吗？
不支持。Mock API 只支持 GET 请求，返回固定 JSON 数据。如需动态 API，建议使用专业 Mock 工具（如 Postman Mock Server、Mockoon）。

🛠️ 工具集

Q12: JWT 工具支持哪些算法？
  • 解码：支持所有标准算法（HS256/HS384/HS512/RS256/RS384/RS512/ES256/ES384/ES512）
  • 生成：仅支持 HS256（对称加密）和 RS256（非对称加密）
注意：JWT 工具仅用于开发测试，不要在生产环境中使用浏览器生成的 Token。
Q13: 代码生成支持哪些语言？
当前支持从 JSON 生成：
  • TypeScript 接口（interface）
  • Java 类（POJO + Lombok）
  • Python dataclass
  • Go struct（带 json tag）
自动处理驼峰/蛇形命名转换。

🔧 技术问题

Q14: 为什么编辑器无法粘贴内容？
可能原因：
  • 浏览器权限：部分浏览器需要手动允许剪贴板访问权限
  • 文件过大：超过 10MB 的内容无法粘贴
  • 插件冲突：禁用广告拦截器或隐私插件后重试
建议使用 Chrome、Firefox 或 Edge 最新版本。
Q15: 暗色模式如何切换？
点击右上角 🌙 / ☀️ 图标切换主题：
  • 浅色模式
  • 暗色模式
  • 跟随系统（自动适配系统主题）
设置会自动保存到浏览器，下次访问自动应用。
Q16: 支持离线使用吗？
部分支持。核心功能（格式化、转换、对比、工具集）完全离线可用。AI 助手和 Mock API 发布需要网络连接。

💼 商业与授权

Q17: ForJSON 是免费的吗？
是的。ForJSON 永久免费，无付费计划。AI 额度限制是为了防止滥用，通过邀请机制可永久提升。
Q18: 可以商业使用吗？
可以。ForJSON 允许个人和企业免费使用，包括内部工具和商业项目开发。但不得：
  • 二次打包售卖
  • 移除版权标识
  • 将其作为 SaaS 服务对外销售

🤔 还有其他问题？

访问 GitHub Issues 提交问题

或发送邮件至 support@forjson.com