:author: 田冬冬, 王亮, 陈箫翰
:date: 2025-05-08

.. index:: ! clear
.. program:: clear

clear
=====

:官方文档: :doc:`gmt:clear`
:简介: 删除缓存目录、数据目录或会话目录，以及当前配置文件

语法
----

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

可选选项
--------

.. note::

   除 ``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**）及其内容。

    .. note::

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

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

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

.. include:: explain_-V.rst_

.. include:: explain_help_nopar.rst_

示例
----

清空GMT缓存目录::

    gmt clear cache

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

    gmt clear settings

删除所有地球相关数据::

    gmt clear data=earth

相关模块
--------

:doc:`begin`,
:doc:`docs`,
:doc:`end`,
:doc:`figure`,
:doc:`inset`,
:doc:`subplot`,
