编辑器工具

工具如何打开

这些工具只存在于代码编辑器内部，不是主分页中的页面。请先打开一个文件或项目，再使用编辑器顶部的扳手按钮。

1. 1点按编辑器顶部栏中的扳手按钮（更多选项）。会打开一个面板，里面有搜索框 搜索操作…。
2. 2选择一个分区标签：编辑、视图、转到、Git、AI 或 工具，也可以在搜索框中输入，一次过滤所有操作。
3. 3在 工具 中，操作分为 运行、项目、协作、实用工具 和 帮助与设置。调试、测试资源管理器和依赖项在 运行 下；Docker 工具、监控和后端生成器在 项目 下；实时协作在 协作 下。
4. 4问题 和 大纲 在 转到 下。AI 生成器 和 AI 代码操作在 AI 下。
5. 5命令面板（外接键盘上按 Ctrl+Shift+P）列出的正是同样的操作：菜单和命令面板共用同一个注册表。

各工具的位置

底部面板、停靠面板、对话框还是侧栏

快捷键

调试

调试会在附加调试器的情况下运行当前打开的文件，并在停靠于编辑器下方的面板中显示程序正在做什么。调试器仅对 JavaScript 是真实的（.js、.mjs、.cjs、.jsx，运行在内置的 Node.js 上）。对于其他任何语言，调试文件 只是运行该文件。

断点

• 点按编辑器中的行号即可添加或移除断点，也可以在光标所在行按 F9（切换断点）。会话开始之前就可以设置。
• 断点只保存在内存中：关闭应用后就会丢失。
• Breakpoints 标签页列出所有断点，每个都有开关框。点按一行可跳到当前文件中的对应行，用铅笔编辑，用 ✕ 移除，或点 全部清除。列表为空时显示：“没有断点。点按编辑器中的行号即可添加。”

启动与单步执行

Node 会在第一行暂停启动（--inspect-brk），面板随后附加并放行，程序一直运行到命中断点或遇到未捕获的异常，后者同样会使其暂停（运行输出中会出现“Debugger attached on port N”）。

• 会话进行中，工具栏提供 继续（程序运行时为 暂停）、单步跳过、单步进入、单步跳出、重新开始 和 停止。单步按钮只在程序暂停时可用。
• 停止 会分离调试器。进程本身要在运行面板中停止。
• 火焰图标开关 热重载：保存项目文件时重启调试会话 默认关闭。

四个标签页

标签页名称始终是英文：应用没有翻译它们。

条件与日志断点

断点上的铅笔会打开 编辑断点。条件（“仅当此 JavaScript 表达式为真时暂停”）会让它只在条件成立时停下。日志消息（“记录日志而不暂停。使用 {表达式} 插入值”）会把它变成日志断点：只输出消息，不暂停。两者都填时，只在条件为真时输出。这两个字段只能在这里设置，不能从编辑器边栏设置。

测试

测试资源管理器会找到项目的测试，用框架自带的命令运行它们并列出结果。它不自带测试运行器：它通过设备的 shell（sh -c）在项目文件夹中运行命令，所以设备上必须有该框架的工具。

框架与检测

支持十二个框架：Jest、Mocha、Vitest、pytest、unittest、JUnit、Go Test、Cargo Test、PHPUnit、RSpec、Dart Test 和 Swift XCTest。PocketCode 为每个项目选一个：先按配置文件找到的第一个（例如 jest.config.js、pytest.ini、build.gradle、go.mod、Cargo.toml、pubspec.yaml）；如果都不匹配，就读取 package.json 来判断 Jest、Vitest 或 Mocha。unittest 没有配置文件，所以不会被自动选中。之后副标题会显示“<框架> · 共 M 个文件，N 个测试”。

四个标签页

运行

• 底部有 运行全部、仅失败，运行期间还有 停止。
• 顶部有 刷新、切换监视模式 和 带覆盖率运行 图标。
• 测试树来自按名称模式读取你的文件（*.test.*、test_*.py、*_test.go、*Test.kt…），最多 200 个文件，并跳过 node_modules、.git、build、dist、target、.gradle、__pycache__ 和 venv。
• 监视模式只有 Jest、Mocha 和 Vitest 支持，而且只是把命令的输出持续输送到 输出 中。

Docker 工具

Docker 工具是你设备上已有的 docker 命令行工具的前端。PocketCode 不包含 Docker 或 Docker 守护进程，面板也没有远程主机输入框。所以在典型的手机上，需要 Docker 的标签页会显示 无法访问 Docker，而 Dockerfile 和 Compose 编辑器仍可使用。

当 Docker 不存在时

打开时，面板会运行 docker --version。如果失败，容器、镜像、构建 和 镜像仓库 会显示 无法访问 Docker：“PocketCode 在此设备上运行 docker 命令，但没有找到它。你仍然可以编辑 Dockerfile 和 Compose 文件。”它还会给出失败的真实原因和两个按钮：重试 和 编辑 Dockerfile。副标题显示 Docker 不可用。

Dockerfile 与 .dockerignore

这个标签页无需 Docker 即可使用。从 14 个模板中选一个开始：Node.js App、Python App、Java App、Go App、Rust App、Static Site、React App、Next.js、FastAPI、Spring Boot、Django、Ruby on Rails、Laravel、Custom Multi-stage；编辑文本后 保存 为项目中的 Dockerfile。对于 .dockerignore，你可以 生成 一个文件并保存。

Compose

九个模板：Full-stack Node.js、Full-stack Python、Full-stack Java、LAMP Stack、MEAN Stack、Monitoring Stack、ELK Stack、WordPress 和 Dev Tools。编辑后 保存 文件；它总是保存为 docker-compose.yml，尽管面板会读取 docker-compose.yml、docker-compose.yaml、compose.yml 或 compose.yaml。有 Docker 时，Compose up、Compose down、Compose build 和 Compose logs 会运行 docker compose up -d、down、build 和 logs --tail=100；在项目有 Compose 文件之前它们保持禁用。

有 Docker 可用时

命令的限制

每条命令最多运行 300 秒。名称和标签在传给 Docker 之前会先被检查：只能含字母、数字和 _ : . / @ -，最长 255 个字符，且不能以 - 开头。

监控

监控测量的是你正在使用的应用以及它所运行的设备，而不是某台服务器。面板打开期间每 2 秒采样一次，关闭后停止。如果要查看你自己的服务器，有一个单独的 服务器 标签页。

五个标签页

警报规则

规则表单包含 指标、条件（大于 或 小于）、阈值（会按该指标的取值范围检查）、持续时间（秒） 和 严重程度（致命、警告、信息）。警报事件只在面板打开时才会被评估和显示；保留最近 100 条，每条规则每分钟最多一条。

服务器：你自己的 Prometheus

服务器 可用于 Prometheus、VictoriaMetrics、Thanos、Mimir、Cortex 或 Grafana 代理。输入 地址，选择 身份验证（无、用户名和密码 或 Bearer 令牌），选择刷新间隔（5 到 300 秒，默认 15），并最多添加 12 条查询；每条都是一个 PromQL 即时查询，必须返回单个值。测试连接 用来检查配置。在你配置之前，该标签页显示“尚未配置服务器。在你配置之前，不会有任何数据离开本设备。”

库

库（菜单中称为 依赖项）不是包管理器。它列出项目在 .pocketcode/dependencies.json 中声明的 Kotlin/JVM 库，并让你从一个封闭的目录中挑选，目录里是随 PocketCode 应用一起提供的四个库。只有完整的 Kotlin 运行器会使用它们。

目录

目录 标签页列出 PocketCode 自带的四个库：kotlinx.coroutines 1.10.2、kotlinx.serialization · JSON 1.7.3、kotlinx.serialization · core 1.7.3 和 Okio 3.9.1。每一行的 + 图标（添加 加上库名）会把它加入项目。

已声明

已声明 标签页列出项目的 JSON 所声明的内容，筛选项有 全部、可更新 和 未包含。每一行显示 group:artifact 以及 PocketCode 是否包含它（“PocketCode 已包含。”，或在项目要求另一个版本时显示“a → b”），并带有更新图标和移除图标。底部的 更新 N 个 会更新所有可更新的库，也就是把它设为 PocketCode 自带的版本。标题栏中的刷新图标（立即解析）会重新准备这些库，状态依次为“正在准备库…”和“已就绪：本项目的库已准备好。”没有声明时显示 没有依赖。

未包含的库

如果 JSON 中写了目录之外的内容，该行会说明它不随 PocketCode 提供，“因此本项目将以简易模式运行。请移除它，或改用上面的库。”

后端生成器

后端生成器根据存储在应用中的模板编写服务端代码。它不是 AI：相同的设置总会得到相同的文件（生成 按钮只是先等一小会儿）。你在面板中阅读结果，打开项目时可以把它保存到 backend/ 下。

标签页

保存到项目

保存到项目 会把生成的文件写入项目的 backend/ 下；迁移会变成 backend/up.sql 和 backend/down.sql，规范会变成 backend/openapi.yaml 或 backend/openapi.json。路径不能跑出项目文件夹。如果已有部分文件存在，它会询问 要覆盖文件吗？（“项目中已存在 N 个文件，将被覆盖。”）。成功时提示“已将 N 个文件保存到项目的 backend/ 目录”，写入失败时提示“无法保存生成的文件”。它需要打开一个项目。

AI 生成器

AI 生成器 有五个标签页，但只有三个使用 AI。API 和 架构 是在设备上运行的离线模板；翻译、安全 和 性能 会把你粘贴的代码发送给你已连接的 AI 提供商。

五个标签页

AI 标签页需要什么

需要已连接的 AI 提供商和互联网。第一次使用时，会有一条提示询问 发送给 <provider>？；发送 会共享你粘贴的代码，取消 则什么都不共享。API 和 架构 既不需要提供商也不需要网络。生成之前，结果区显示“生成后结果会显示在这里。”

AI 代码操作

菜单的 AI 分区里有一组作用于你代码的操作：解释、测试、文档、根据注释生成代码、重构，以及五个快捷操作。它们会在你接受一条提示后，把代码发送给你已连接的 AI 提供商，并显示回答。

各项操作

停靠面板中的“应用”和“插入”

停靠面板最高 300 dp，带有一个用来关闭的 ✕。插入 会把回答放在光标处。应用 只会用回答替换发送给 AI 的那段代码（生成文档 是那个函数；重构 是选区，没有选区时是整个文件），没有预览，且只需一步撤销。如果在 AI 回答期间你改动了那段代码，导致找不到它，就不会改动任何内容，面板会提示“AI 回复期间代码已被修改，因此未应用结果。请改为复制。”复制 按钮位于生成的代码旁，会把它复制到剪贴板（“已复制到剪贴板”）；底部面板有自己的 复制，用来复制整条回答。

实时协作

实时协作让两台或更多设备在同一 Wi-Fi 网络下共同编辑同一个文件。它免费、不需要账号，也没有服务器：主持人的手机在你的本地网络中监听，访客找到它、输入六位数字码，由主持人放行。没有任何内容经过互联网。

主持会话

1. 1在 在此设备上主持 下输入会话名称，并点按 开始主持。会话共享你当前打开的文件的文本。
2. 2把六位数字的 配对码 告诉要加入的人（“把这个码告诉要加入的人”）。
3. 3有人输入了正确的码时，你的设备会询问 有人想加入：“<name> 输入了正确的配对码。让其加入即表示把文件分享给对方的设备。”选择 让其加入 或 拒绝。你最多有 90 秒。
4. 4用标题栏中的 结束会话 结束它。

加入会话

1. 1在同一 Wi-Fi 下打开面板。网络中的对等端 会扫描局域网（正在扫描局域网…），如果没有人在主持，则显示 未找到对等端。
2. 2在 主机的配对码 中输入主持人的六位数字（“没有它谁也进不来。会话不会离开你的网络。”）。
3. 3点按主持人，并等待它放行（最多 120 秒）。你之前打开的文件的内容会被主持人的文本替换。
4. 4用标题栏中的 离开 离开。

会话之中

共享了什么

• 会话开始时主持人当前文件的文本。一个会话共享一个缓冲区：不是项目树，也不是其他文件。
• 之后，所有人的编辑会合并（CRDT），远程光标会在编辑器中以名称和颜色显示。
• 主持人转发一切：访客与主持人通信，而不是彼此通信。
• 主持人放行的每位访客都可以编辑共享文本。
• 如果某位访客的连接断开，应用最多重试六次（间隔从 1 秒逐渐增加到 15 秒），并整合期间输入的内容。

网络与权限

从 Android 13 起，主持和加入需要 Android 的附近设备权限（在最新的 Android 版本上是本地网络权限）。当你开始主持、扫描或加入而缺少该权限时，会弹出 Android 自己的权限对话框：允许后再点按一次。如果你拒绝，主持和加入仍会被拒绝（下一次尝试会再次显示说明），直到你在 Android 的应用设置中允许它。权限说明和连接错误会以应用的语言显示。

问题

问题是一份汇总列表，列出编辑器在所有打开的标签页中发现的一切问题，并按文件分组。它是一个全屏对话框，而不是底部面板。

筛选

可按来源筛选——编译器/LSP、标记 和 风格，各带有计数——也可按严重程度筛选——错误、警告、信息 和 提示。编译器/LSP 和标记默认开启。风格（lint 规则）只有在你打开它时才会计算，并显示“正在分析风格…”，对话框关闭时不会计算任何内容。

行

问题会去重，并按严重程度再按行号排序。点按一行即可跳转到“行 N，列 M”。当前文件所在的分组有 快速修复，它会打开快速修复面板。F8 和 Shift+F8 无需打开对话框，就能跳到下一个或上一个错误、警告或 TODO 标记。没有内容可显示时显示 未发现问题。

大纲

大纲是编辑器右侧的一列，列出文件中的类、接口、函数、导入块和 // region 区域，并可跳转到它们。它由一个简单的解析器生成，不使用语言服务器。

它能识别什么

• 以 class、interface、object、enum class、fun 或 suspend fun 开头并带有 { 的行，即 Kotlin 风格的声明。
• 由三行或更多连续的、以 import 开头的行组成的块。
• 以 // region Name 写出并以 // endregion 结束的区域。
• 它会在你停止输入 0.8 秒后刷新。

使用方法

在 筛选符号… 中输入（匹配文本的一部分，不是模糊匹配），点按一项即可跳转到它所在的行。筛选没有匹配项时显示 无符号。