一个小型、跨平台的 Python 工具，用于在单个 JSON 文件或目录（递归）内查找指定字段名并将其值替换为用户提供的统一内容。
- 在 Web UI (
templates/jsonmgr/view.html) 中新增左上角侧边栏，用于浏览仓库中的 JSON 文件和 backups；侧边栏支持平滑展开/收起并能浏览备份子目录。 - 修复模板中的若干 JS 与缩进问题，清理了生成补丁时遗留的无效标记，确保页面脚本能正常运行。
- 增加了异步加载完整文件的按钮（在大文件被截断显示时可点击加载完整内容），并提供
/api/files简单接口以便客户端获取文件与备份列表。
（详见 templates/jsonmgr/view.html 与 jsonmgr/views.py）
- 支持对单个文件或目录递归处理（按扩展名过滤，默认
.json）。 - 支持将替换值按字符串处理或解析为 JSON 字面量（数字、布尔、数组、对象、null）。
- 为每个被修改的文件生成备份，备份文件名包含时间戳，便于恢复。
一个小型、跨平台的 Python 工具，用于在单个 JSON 文件或目录（递归）内查找指定字段名并将其值替换为用户提供的统一内容。
- 支持对单个文件或目录递归处理（按扩展名过滤，默认
.json）。 - 支持将替换值按字符串处理或解析为 JSON 字面量（数字、布尔、数组、对象、null）。
- 为每个被修改的文件生成备份，备份文件名包含时间戳，便于恢复。
主脚本：replace_json_field.py
--path <path>(必需)：要处理的文件或目录路径。如果是目录，会按--ext递归查找。--field <name>(必需)：要替换的字段名（精确键名匹配，区分大小写）。--value <value>(必需)：替换值，默认按字符串处理。--json-value(可选)：如果指定，脚本会将--value当作 JSON 字面量解析（例如123、true、[1,2]或{"a":1}）。--ext <ext>(可选)：当--path指向目录时，按该扩展名过滤文件（默认.json）。可以传json或.json。
在 PowerShell 中将 test.json 中所有键 name 的值替换为字符串 REPLACED：
python .\replace_json_field.py --path .\test.json --field name --value REPLACED在 PowerShell 中，将 data 目录内所有 .json 文件里键 meta 的值替换为对象（注意引号转义，外层使用单引号）：
python .\replace_json_field.py --path .\data --field meta --value '{"a":1, "b":[2,3]}' --json-value在 bash（Linux/macOS）下传入 JSON 字面量示例：
python ./replace_json_field.py --path ./test.json --field foo --value '{"k": "v"}' --json-value本仓库包含一个最小的 Django 前后端（应用名 jsonmgr），用于通过浏览器查看、下载和在页面上替换 JSON 文件字段。
重要说明：默认页面读取位置为仓库根的 json_files/ 目录（即 d:\桌面\json字段处理\json_files），备份会写入 json_files/backups/。请确保该目录存在且可读写。
快速启动（PowerShell）
# 建议先在虚拟环境中运行
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python manage.py migrate --noinput
python manage.py runserver 0.0.0.0:8000
# 在本机浏览器访问 http://localhost:8000/ 或 http://<本机IP>:8000/页面功能简要：
- 首页
/：列出json_files/下所有.json文件并支持即时搜索。 - 文件页
/file/?name=<file>：展示（截断）文件内容、支持替换字段并保存，提供/raw/?name=<file>下载完整文件或在页面异步加载完整内容。
安全提示：生产环境不要使用 Django 开发服务器做对外服务；在内网或本地开发测试用途下可以使用上面的 runserver 命令。
- 脚本和 Web UI 都会在写回前生成备份，文件在
json_files/backups/，文件名包含.bak-<timestamp>。 - 恢复示例（PowerShell）：
Copy-Item -Path .\json_files\backups\test.json.bak-1612345678 -Destination .\json_files\test.json -Force- 字段名匹配为精确键名（区分大小写）。脚本会在任意嵌套层级（对象、数组中的对象）查找并替换匹配项。
- 对于同名键，脚本会替换所有出现的位置。如果你只想替换顶层字段或按路径筛选，需要对脚本进行扩展。
- 使用
--json-value时，--value必须是合法 JSON 字面量。PowerShell 中通常外层使用单引号包裹整个 JSON 字符串以保留内部双引号。 - 当遇到无法解析为 JSON 的文件时，脚本会跳过该文件并打印警告信息，原始文件不会被覆盖。
- Python 版本：推荐 Python 3.8+（本次开发使用 3.11）
- 依赖见
requirements.txt（示例包含 Django）
- 如果看到“无法解析为 JSON”的错误，请用
python -c "import json,sys; json.load(open('file'))"或在线 JSON 校验工具确认该文件是合法 JSON。 - 在 PowerShell 里传递 JSON 字面量时，请使用单引号包裹外层字符串，内部用双引号；或者对双引号进行转义。
- 增加
--dry-run模式，仅打印将被替换的键与位置，不写回文件。 - 支持按 JSONPath 精确定位要替换的条目。
- 支持并行处理大目录以及备份保留策略（保留最近 N 个备份）。
- 访问主页：在本机运行
python manage.py runserver后访问http://localhost:8000/，页面会列出json_files/下的可用.json文件。 - 打开文件：点击某行或通过
?name=<file>参数访问文件页面。 - 文件展示：对于大文件，页面默认只显示前 200KB，并在顶部以斜体注释提示“注：文件较大，只显示前 200KB（可点击下载或在页面异步加载完整内容）”。可点击“在页面加载完整文件”按钮获取完整内容并一次性渲染。
- 编辑替换：页面下方提供字段名与替换值输入框，勾选“值为 JSON 字面量”以将替换值按 JSON 解析。提交表单会在写回前生成备份。
- 侧边栏：左上角菜单按钮打开侧边栏，可浏览仓库文件并展开 backups 目录；支持平滑动画与嵌套备份浏览。
GET /api/files— 返回 JSON 对象{ files: ["a.json", ...], backups: { "a.json": ["a.json.bak-...", ...], ... } }。用于客户端异步加载文件与备份列表。GET /raw/?name=<file>— 返回指定文件的原始内容（用于下载或在页面加载完整内容时请求）。
- 建议使用 Python 虚拟环境：
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt- 迁移并启动开发服务器：
python manage.py migrate --noinput
python manage.py runserver 0.0.0.0:8000- 如果修改
templates/jsonmgr/view.html，浏览器刷新后即可看到更改（开发模式下 Django 会自动加载模板变更）。
- 快速替换：将
json_files/test.json中所有name字段替换为字符串REPLACED：
python .\replace_json_field.py --path .\json_files\test.json --field name --value REPLACED- 使用 Web UI 在页面上替换：打开
http://localhost:8000/→ 点击某文件 → 在替换表单中填写字段名和值并提交。
-
Q：如何恢复某次备份？
- A：备份保存在
json_files/backups/，你可以手动将备份复制回原文件名（示例见上文）。
- A：备份保存在
-
Q：如何避免误替换？
- A：先备份整个目录或使用版本控制；或在脚本中实现
--dry-run模式以预览变更。
- A：先备份整个目录或使用版本控制；或在脚本中实现