🚣
快速开始

用户66

2025年9月24日修改

下载插件

Idea 内插件市场直接搜索 xcodemap 下载安装，要求 Idea 版本 2022.2 及以上。​

🦄

XCodeMap 支持纯内网使用。可以通过外网访问 https://plugins.jetbrains.com/plugin/24648-xcodemap 下载插件安装包，传输到内网，然后通过 Install from Disk（从磁盘文件安装）的方式进行安装。

Idea 版本问题

Mac 系统下，部分 Idea 版本，比如 2025.1.x（包括最新的 2025.1.6），会导致滚动不顺畅。​

📔

目前实测 2022.2.2 和 2025.2.2 正常。Windows 系统不受影响。

插件主界面概览

如果你看到这个插件主界面，恭喜你，插件安装成功了。界面内有一个简要文档，列出了一些重要的功能，方便平时速查。​

启动程序 with XCodeMap

XCodeMap 作为一个插件，需要与程序一起启动，以附着 Agent 在程序上，录制程序执行过程，然后进行回放。​

在 Idea 启动程序的位置处上，可以看到“Debug xxx with XCodeMap” 的按钮，点击即可带插件启动程序。​

其启动方式与 Run、Debug 等并列，本质上差不多，只不过启动时，附着了 XCodeMap 的录制 Agent。在 RunConfiguration、Main 方法、Services 等出现 Run、Debug 的地方，都会顺带出现 “Debug with XCodeMap” 的按钮。​

✍️

XCodeMap 支持随着 Debug 按钮默认启动（需要在配置页开启）。如果习惯了使用 XCodeMap，这样启动会更方便快捷。默认启动，可以配合 Jrebel 等热更新插件使用，打造更加丝滑的调试体验。​

录制程序

Debug with XCodeMap 启动成功后，默认会弹出插件主界面（可以在配置页关闭默认弹窗），看到“开始录制”的按钮。​

点击“开始录制”，则 XCodeMap 会开始录制程序数据。此时，如果你使用 Postman 之类的工具发起一个 Http 请求，则会看到如下的界面：​