--- title: "使用 VSCode 查看和编辑 Minecraft 存档的 NBT" date: 2025-03-15T22:16:38Z lastmod: 2025-03-15T22:22:27Z tags: [Minecraft,教程,工具,VSCode,NBT] --- # 使用 VSCode 查看和编辑 Minecraft 存档的 NBT ## 简介 目前已知常用的 NBT 数据编辑工具有 NBTExplorer、Universal Minecraft Editor、webNBT 等，但他们目前都不太兼容 Minecraft 1.12.2 以上版本的存档。 实际上，除了使用上述的几款工具以外，还可以使用 VSCode 编辑 NBT 数据。主要用到**由 Misode 开发的 NBT Viewer 扩展**（[misode/vscode-nbt: NBT extension for VSCode](https://github.com/misode/vscode-nbt)）。本文将会从 VSCode 的安装开始讲述使用方法。 ## 一、安装 VSCode 1. 访问 VSCode 官网（[code.visualstudio.com](https://code.visualstudio.com/)），点击页面左侧的下载按钮，下载自动识别的版本，或点击 “other platforms”，根据实际情况下载合适的版本。 > 注：若下载速度较慢，可参考文末中的 “VSCode 安装包下载太慢” 解决方法。 > ![image](assets/network-asset-vscode-download-1-20250315221732-pbbk9r2.png) 本文中以 Windows 平台 `System Installer`​ `x64`​ 为例。 ​![image](assets/network-asset-vscode-download-2-20250315221732-ydvbqhq.png) 若有需要，可以访问 “[Setting up Visual Studio Code](https://code.visualstudio.com/docs/setup/setup-overview)” 页面查看安装说明文档（英文）： ​![image](assets/network-asset-vscode-setup-doc-20250315221732-5nop15f.png) 2. 下载完成后，双击运行安装程序以开始安装。 ​![image](assets/network-asset-vscode-exe-20250315221732-z39ucpa.png) 3. 根据提示进行相关操作，直到安装完成： ​![image](assets/network-asset-vscode-setup-1-20250315221733-72b0edr.png) ​![image](assets/network-asset-vscode-setup-2-20250315221733-mo1zslf.png) ​![image](assets/network-asset-vscode-setup-3-20250315221733-tn3mz90.png) ​![image](assets/network-asset-vscode-setup-4-20250315221733-lncj84v.png) ​![image](assets/network-asset-vscode-setup-5-20250315221733-yvrwxxi.png) ## 二、安装语言包 在系统菜单或桌面中找到 VSCode，运行。初次启动时，软件右下角会根据当前系统语言设置，提示安装对应的语言包。若点击 “安装并重启” 按钮，软件将会自动安装语言包并重启。 ![image](assets/network-asset-vscode-first-launch-20250315221733-6jgjbd0.png) --- 若有需要，可以按下 `Ctrl + Shift + P`​ 或 `F1`，输入 “display language”，选择 “Configure Display Language”，然后选择安装所需的语言包。 > 注：使用 `↑`​ `↓`​ 键切换选项，按下 `Enter` 键进行确认。 ![image](assets/network-asset-vscode-configure-display-language-20250315221734-iudmfwz.png) ![image](assets/network-asset-vscode-select-language-pack-20250315221734-h6w04w1.png) 选择语言后，会提示需要重启以生效。若点击 “Restart” 按钮则自动重启，若点击 “Cancel” 按钮则可以在稍后手动重启。 ![image](assets/network-asset-vscode-language-pack-restart-20250315221734-bhzvs3f.png) ## 三、更改默认设置和主题 若有需要，可以先对软件的默认设置进行一些调整以及更换主题。 ![image](assets/network-asset-vscode-change-default-settings-20250315221734-8d97hmy.png) ![image](assets/network-asset-vscode-change-default-theme-20250315221734-9qceson.png) ## 四、安装 NBT Viewer 扩展 点击左侧边栏中的 “扩展” 图标，然后在输入框中填写 “Misodee.vscode-nbt” 或 “NBT Viewer” 进行搜索。 > 若使用关键词 “NBT Viewer” 进行搜索，可能会有多个结果，请注意不要安装错。 ![image](assets/network-asset-vscode-search-nbt-viewer-20250315221734-oq5endx.png) 点击 “安装” 按钮，安装找到的 NBT Viewer 扩展。 ![image](assets/network-asset-vscode-install-nbt-viewer-20250315221734-6wylbjd.png) ## 五、打开存档文件夹 点击左侧边栏中的 “资源管理器” 图标，然后点击 “打开文件夹” 按钮选择存档文件夹，或直接将存档文件夹拖动到左侧区域以打开。 ![image](assets/network-asset-vscode-resource-manager-20250315221735-amxkeq2.png) 初次打开文件夹时会弹出 “信任文件夹” 对话框，根据需要选择即可（不影响 NBT Viewer 扩展的正常使用）。 ![image](assets/network-asset-vscode-trust-folder-20250315221735-44tp8j0.png) --- 若有需要，可以按下 `Ctrl + Shift + P`​ 或 `F1`，输入 “workspace trust”，选择 “Manage Workspace Trust”，查看工作区信任配置情况。 > 注：使用 `↑`​ `↓`​ 键切换选项，按下 `Enter` 键进行确认。 ![image](assets/network-asset-vscode-manage-workspace-trust-1-20250315221735-kinmnr6.png) ![image](assets/network-asset-vscode-manage-workspace-trust-2-20250315221735-jdc14gu.png) --- 如果需要添加多个文件夹，可以通过将文件夹拖动到文件列表中，或选择菜单（工具栏 / 右键菜单）中的 “将文件夹添加到工作区” 项的方式进行添加。 ![image](assets/network-asset-vscode-add-folder-20250315221735-gpztq20.png) 在弹出的对话框中选择 “将文件夹添加到工作区”。 ![image](assets/network-asset-vscode-open-folder-20250315221735-hawxfl5.png) ## 六、查看和编辑 NBT 数据 单击左侧文件列表中文件项即可将其打开： ![image](assets/network-asset-nbt-open-level-dat-20250315221735-5pv885l.png) 注意：通过 “单击” 方式打开的文件默认不保持打开，会在**打开其他文件时自动关闭**。通过 “双击” 方式打开，或点击文件标签页右键菜单中的 “保持打开状态” 项，可以把它变为 “保持打开”。 ![image](assets/network-asset-vscode-keep-open-20250315221736-scacdfz.png) 打开文件后，需要**等待 NBT Viewer 扩展从 GitHub 下载所需要的依赖文件后才能看到内容**。由于服务器在国外，**你可能需要使用网络加速工具以提高下载速度**。在 VSCode 的 “输出” 面板中可以看到详细情况： ![image](assets/network-asset-vscode-view-output-20250315221736-z53qis5.png) ![image](assets/network-asset-nbt-downloading-outputs-20250315221736-3yeszbs.png) 目前该扩展支持读取的文件类型： ![image](assets/network-asset-nbt-support-file-1-20250315221736-p5rcfo9.png) ![image](assets/network-asset-nbt-support-file-2-1-20250315221736-ned6gpf.png) ![image](assets/network-asset-nbt-support-file-2-2-20250315221736-khkl54l.png) ![image](assets/network-asset-nbt-support-file-2-3-20250315221737-j62zsid.png) ![image](assets/network-asset-nbt-support-file-3-20250315221737-q7lu500.png) ## 常见问题 ### VSCode 安装包下载太慢 1. 在 VSCode 的下载页面根据需要点击下载按钮。 ​![image](assets/network-asset-faq-installer-download-slow-1-20250315221737-ihrkqkr.png) 2. 等待开始下载。 ​![image](assets/network-asset-faq-installer-download-slow-2-20250315221737-qb1gq9i.png) 3. 打开浏览器的 “下载” 页面，复制安装包的下载链接。 ​![image](assets/network-asset-faq-installer-download-slow-3-20250315221737-zgc931w.png) 4. 将下载地址中的 `az764295.vo.msecnd.net`​ 部分替换为 `vscode.cdn.azure.cn`​，填入到浏览器的地址栏中访问，以通过国内的镜像服务器进行下载。 ​![image](assets/network-asset-faq-installer-download-slow-4-20250315221737-y875dvj.png) ​![image](assets/network-asset-faq-installer-download-slow-5-20250315221737-ngc984s.png) ‍