VSCode中批量重命名配色文件需用终端命令而非多选+F2，因不支持多文件统一重命名；必须确保文件名与JSON内"id"字段严格一致，改名后需重启VSCode并可能需清理globalStorage缓存。
VSCode 里批量重命名配色文件（即 color-theme.json 或 themes/ 下的 JSON 文件）不能靠右键多选+F2——它不支持多文件统一重命名，必须用命令行或手动逐个改名+同步更新引用。
配色文件名和主题 ID 必须严格一致
VSCode 主题识别依赖文件名与内部 "id" 字段完全匹配。比如文件叫 my-dark-theme.json，但内容里写的是 "id": "my-light-theme"，VSCode 就会加载失败或显示为未启用。
- 改名前先打开文件，确认
"id"字段值（通常在顶部附近），记下来 - 再把文件重命名为完全相同的字符串，加 .json 后缀，例如
my-dark-theme.json - 如果原文件在
~/.vscode/extensions/xxx/themes/下，改名后需重启 VSCode 才能重新扫描 - Windows 用户注意：文件系统默认不区分大小写，
MyTheme.json和mytheme.json可能被当作同一文件，导致加载冲突
批量改多个配色文件？用终端命令最稳
别信插件预览，直接进集成终端（Ctrl+`），cd 到 themes 目录后执行：
macOS/Linux：
for f in *.json; do id=$(jq -r '.id' "$f" 2>/dev/null); [ -n "$id" ] && mv "$f" "${id}.json"; done
Windows PowerShell：
Get-ChildItem *.json | ForEach-Object { $id = (Get-Content $_.FullName | ConvertFrom-Json -ErrorAction SilentlyContinue).id; if ($id) { Rename-Item $_.FullName "$id.json" } }
- 这两条命令都先读取
"id"字段，再重命名为对应值，避免手误 -
jq在 macOS/Linux 需提前安装（brew install jq）；PowerShell 版本不依赖外部工具 - 运行前先
ls *.json或Get-ChildItem *.json确认范围，防止误操作
改完名字后主题不显示？检查三个地方
VSCode 不会自动刷新已缓存的主题列表，常见卡点：
-
~/.vscode/extensions/下的扩展目录名变了？主题文件路径变了，但扩展包名没同步更新 → 需重装该扩展或手动修正package.json中的"contributes.themes"路径 - 主题文件里
"label"字段没更新 → 它控制 UI 中显示的名字，和文件名无关，但用户会以为“没生效” - VSCode 正在运行旧实例 → 关闭所有窗口，再用命令行
code --disable-extensions --user-data-dir=/tmp/vscode-test测试是否纯主题问题
真正麻烦的不是改名，而是改完后 VSCode 缓存了旧的 theme registry，且不报错——你得手动删掉 ~/.vscode/User/globalStorage/state.vscdb（或整个 globalStorage 目录）才能强制重建索引。这点几乎没人提，但每次改一堆自定义主题时都会撞上。
