✍️ 田冬冬 , 王亮 , 陈箫翰 • 📅 2025-05-08

# clear

官方文档:

  clear

简介:

  删除缓存目录、数据目录或会话目录，以及当前配置文件

## 语法

gmt clear all | cache | data[=planet] | sessions | settings [ `-V`[level] ]

## 可选选项

备注

除 `gmt clear settings` 以外，本页面其它命令都不应该在脚本里使用。 否则可能会出现各种报错。应当单独打开一个终端窗口执行这些命令。

all

  删除所有项目，包括缓存目录（~/.gmt/cache）、数据目录（~/.gmt/server）、会话目录（~/.gmt/sessions）以及当前配置文件

cache

  删除GMT缓存目录（默认为~/.gmt/cache）及其内容

data[=planet]

  删除GMT数据目录（默认为~/.gmt/server）及其内容。 加上 =planet 则只删除特定星球的数据。目前 planet 只可以取 earth。

sessions

  删除GMT会话目录（默认为~/.gmt/sessions）及其内容。

  备注

  正常情况下，GMT在执行 gmt end 时会自动删除当前会话目录。 但若GMT由于各种原因意外退出导致 gmt end 没有执行，则可能 会导致残留会话目录。

  因而可以不定期地执行 gmt clear sessions 删除残留的会话目录。

settings

  现代模式下删除当前会话的GMT配置参数文件（即 gmt.conf）， 使得所有参数回到GMT系统默认值。

-V

-V[level]

  设置 verbose 等级 [w]。 (参数详细介绍)

-^ 或 -

  显示简短的帮助信息，包括模块简介和基本语法信息（Windows下只能使用 -）

-+ 或 +

  显示帮助信息，包括模块简介、基本语法以及模块特有选项的说明

-? 或无参数

  显示完整的帮助信息，包括模块简介、基本语法以及所有选项的说明

## 示例

清空GMT缓存目录:

    gmt clear cache

删除现代模式会话下的当前配置参数文件:

    gmt clear settings

删除所有地球相关数据:

    gmt clear data=earth

## 相关模块

begin, docs, end, figure, inset, subplot,