文件浏览器

你可以

• 点按文件夹 展开或收起它。点按文件 在 IDE 页面中打开它。
• 打开行菜单：使用该行上的 ⋮ 按钮。
• 看懂图标：文件如果有对应的语言或工具图标就使用它，否则显示普通文档图标；文件夹显示由其名称决定的双层图标（src、test、docs、components…… 超过 900 个名称有对应图标）。
• 看懂计数：N 个文件夹 · M 个文件 统计页面到目前为止读取到的所有内容，包括目录树隐藏的条目，并且只统计你展开过的文件夹。它可能与你看到的行数不同。
• 全部折叠：⋮ → 折叠；项目根目录保持展开。
• 找到已打开的文件：⋮ → 定位当前文件，它会展开所在的文件夹并滚动到该文件。仅在有文件打开时才显示此项。
• 显示隐藏文件，例如 .gitignore 或 .env：⋮ → 显示隐藏文件。它们默认是隐藏的。
• 保持你的位置：只要你停留在同一个项目，你展开的文件夹就保持展开。切换项目会重置它们。

你不能

• 看到 node_modules、.git、.gradle、build、.idea、__pycache__、.DS_Store、.cache 或 .pocketcode。这九个名称由固定列表隐藏，即使开启 显示隐藏文件 也一样，你自己建的名为 build 的文件夹同样会被隐藏。有意为之

你可以

• 查看改动了什么，无需打开 Source Control。
• 沿目录树向上追踪改动：文件夹带有其内容中最强的状态。
• 放心它们是最新的：页面会在打开项目时、在本页每次操作之后、在编辑器中每次保存之后、在 AI 智能体更改文件时，以及点按 刷新 时重新读取 Git。

你不能

• 在本页暂存、提交或对比：它只显示状态。请从 项目 中的项目卡片，或编辑器中的 Source Control 提交。有意为之
• 看到 R（重命名）或 I（忽略）标记。应用定义了这两个字母，但从不分配它们，所以它们永远不会出现。尚未提供

你可以

• 按顺序输入字母，不必相邻：mact 能找到 MainActivity。最佳匹配排在最前：先是完全相同的名称，然后是以你输入的文本开头的名称，然后是单词开头的匹配。
• 输错字母也没关系：如果没有任何字面匹配，搜索会再试一次，最多容忍两处错误（错误、互换或多余的字母）。容错匹配的排名永远不会高于字面匹配。
• 最多获得 200 条结果。 搜索忽略大小写，比较的是名称，而不是路径。

你不能

• 搜索你从未展开过的文件夹：搜索只覆盖页面已经读取的内容。有意为之
• 搜索隐藏或被排除的条目：它遵循与目录树相同的规则，包括 显示隐藏文件 和那九个固定名称。有意为之
• 匹配重音符号：arbol 找不到 árbol。有意为之

你可以

• 按字面搜索，忽略大小写。它不是正则表达式。
• 深入任意文件夹：与目录树不同，这个搜索没有排除列表，因此它也会读取 node_modules、.git 和 build。

你不能

• 在本页搜索整个项目：该面板只能从文件夹的菜单打开。要搜索整个项目，请使用编辑器中的 在文件中搜索。尚未提供
• 直接跳到匹配的行：文件会打开，但编辑器不会被带到那一行。尚未提供
• 搜索 2,000,000 字节或更大的文件（它们会被跳过），或看到超过 200 条结果（搜索到此为止）。有意为之
• 排除二进制文件：搜索会读取所有未超过大小限制的文件，不会检查它是否是文本。有意为之

你可以

• 手动刷新：⋮ → 刷新 会重新读取你展开的每个文件夹以及 Git 标记。不会折叠任何内容。
• 依赖 AI 智能体：当它在已打开的项目中创建、更改、重命名或删除文件时，受影响的文件夹会被重新读取。

你不能

• 不刷新就看到由 Terminal 或其他应用创建的文件：没有任何东西监视文件夹，所以请使用 刷新。有意为之

你可以

• 一次创建多层目录：像 src/util/a.kt 这样的名称还会创建缺失的文件夹。
• 创建已存在的文件夹 不会报错：它视为已完成。
• 看到它出现：新条目会显示在目录树中，并且其所在文件夹会展开。

你不能

• 从已有内容开始：快速模板只决定名称。文件创建后是空的，如果名称已被占用，你会看到 文件已存在，且不会有任何改动。尚未提供

你可以

• 选择是否询问：删除前确认（Settings → 行为，默认开启）同时作用于此菜单中的 删除 和 删除所选。编辑器的资源管理器有自己的对话框，并且始终会询问。

你不能

• 撤销删除：没有回收站，该条目会从设备中移除。有意为之

你可以

• 把副本粘贴任意多次：复制之后剪贴板仍保留内容。目标位置中已存在的名称会变成 name (1).ext、name (2).ext……
• 通过剪切来移动：在至少移动了一个条目的粘贴之后，剪贴板会清空。
• 一次粘贴多个条目；如果有些没有成功，横幅会显示 完成 N 个，失败 M 个。

你不能

• 拖放文件来移动它：移动就是剪切加粘贴（或 移动到文件夹…）。代码中有移动函数，但没有任何界面调用它。尚未提供
• 移动到已被占用的名称上：该条目不会被移动，并计为失败。与复制不同，不会自动为你重命名。有意为之

你可以

• 先询问再删除所选：删除前确认 开启时，删除所选 会打开 删除 N 个项目？（所选文件和文件夹将被永久删除，没有回收站，也无法撤销。），按钮为 删除 和 取消。点按 取消 则一切保持原样。该设置关闭时，这些条目会被直接删除。
• 查看结果：确认后，横幅 已删除 N 个项目 会在结果未知之前立即显示；如果有失败，随后会出现 已删除 N 个，失败 M 个。

你不能

• 撤销从选择栏发起的删除：没有回收站；删除前确认 关闭时，连询问也不会有。有意为之
• 选中不在屏幕上的内容：全选 只标记当前可见的行，因此未展开文件夹中的内容不包括在内。有意为之

你可以

• 进入 PocketCode：从文件管理器、邮件应用或聊天应用中，用 PocketCode 打开或编辑文本文件。它在编辑器中打开，成为带有 设备上 标记的标签页，除此之外什么也不会发生：不保存、不运行、不更换项目。如果发送方应用没有授予写入权限，标签页显示 设备上 · 只读，你可以用 另存为… 保留你的更改。
• 离开 PocketCode：在编辑器中，过大而无法打开的文件（80 MiB 或更大）或二进制文件会显示一张带有 用其他应用打开 的卡片，它会把文件交给你选择的应用。

你不能

• 在「文件」或编辑器资源管理器的行菜单中使用 打开方式…：只有上面两张卡片提供它。有意为之

你可以

• 另存为…（编辑器，任意标签页）通过系统的保存选择器把副本保存为设备上的新文件，之后你继续编辑这个副本。
• 项目卡片（Projects）上的 导出 通过同一个选择器把整个项目保存为 ZIP，选择器中也会列出 Drive 和其他提供方。应用使用选择器而不是分享面板，这样备份会落在你选择的位置。

你不能

• 从「文件」分享单个文件、文件夹或选中的多个条目。有意为之

你可以

• 用前缀切换搜索对象：> 搜索命令，: 后接数字跳转到某一行，@ 搜索已打开文件的符号。
• 到达任意文件：索引覆盖整个项目，没有深度限制，最多 50,000 个文件。它会排除名称以点开头的文件夹、构建和依赖文件夹（node_modules、build、dist、target、venv……）以及项目的 .gitignore 所列出的内容。.gitignore 这类隐藏 文件 则包含在内。

你不能

• 靠拼写错误找到文件：Quick Open 要求字母按顺序出现，没有容错，这一点与「文件」中的按名称搜索不同。有意为之
• 看到超过 50 条结果，或索引超过 50,000 个文件。有意为之

你可以

• 窄窗口（宽度小于 840 dp，例如竖持的手机或小型平板）：一个宽 320 dp、最多占屏幕 85% 的抽屉，盖在变暗的编辑器之上。它没有边缘滑动打开的方式，因为那个边缘是系统的返回手势。它可通过返回、点按变暗的编辑器、向左滑动关闭，并且在小于 600 dp 时，打开文件也会关闭它。
• 宽窗口（840 dp 或更大，例如横置的平板或横持的大屏手机）：停靠在左侧的面板，默认显示，在你更改之前宽 280 dp。拖动它的右边缘可在 200 dp 到窗口 45% 之间调整大小；宽度会被记住。双击边缘可恢复默认值。使用 TalkBack 时，加宽 和 收窄 无需拖动即可完成。禅模式（Zen mode）会隐藏它。

你不能

• 调整较窄屏幕上抽屉的大小：它自己的边缘已经表示关闭，且最多只占宽度的 85%。有意为之

你可以

• 已打开部分：显示标签页，如 已打开 · 4。点按其中一个切换到它，✕ 关闭它。圆点标记未保存的更改，斜体名称标记预览标签页。
• 项目部分：标题是项目名称，带有 新建文件、新建文件夹 和 全部折叠 按钮，面板停靠时还有筛选按钮。在抽屉中，筛选按钮和 ⋮（刷新、显示当前文件、全部折叠）位于顶部的 资源管理器 栏中。
• 行菜单（长按）：打开、新建文件、新建文件夹、重命名、删除、复制路径 和 复制相对路径。
• 新建文件、新建文件夹和重命名 会在你输入时检查名称，并提示 该名称无效。重命名 会选中不含扩展名的名称部分。你创建的文件会立即作为普通标签页打开。
• 删除 会询问 删除 x？，并说明该文件会从设备中删除，其本地历史记录会保留。如果已打开的标签页有未保存的更改，它会警告这些标签页将在不保存的情况下被关闭。
• 筛选 整个项目的名称：它保留名称包含你输入文本的文件，并把它们显示在各自的文件夹中。
• Git：已更改的文件上有字母 M、A、U、D 或 R，包含更改的文件夹上有一个圆点，并且在抽屉中有一个页脚，显示分支、待推送的提交 ↑、待拉取的提交 ↓ 以及更改数量。被 .gitignore 忽略的条目或构建和依赖文件夹中的条目会变暗，但仍会列出。

你不能

• 剪切、复制、粘贴、创建副本、选择多个、选择排序顺序或关闭点文件：这些属于「文件」页面。有意为之
• 看到 .git 或 .pocketcode：它们从不会被列出。有意为之
• 把冲突或被忽略的标记显示为字母：资源管理器只有五个字母，被忽略的条目改为变暗显示。有意为之

你可以

• 备份项目：使用其卡片上的 导出（用系统选择器保存的 ZIP），或用 Git 推送它。
• 在这里找到示例项目 WebPortfolio 和 TaskCLI：应用在首次启动时把它们放在同一个位置。

你不能

• 从其他应用或文件管理器查看或编辑你的项目：私有存储对其他应用是关闭的。卸载 PocketCode 时，项目会一并被删除。设备
• 把项目保存在共享文件夹中：Projects 中的 打开文件夹 会把你选择的文件夹复制到应用的存储中，之后的编辑不会回写到原文件夹。设备