# unset

删除指定的shell变量或函数。

## 概要

```
unset [-f] [-v] [-n] [name ...]
```

## 主要用途

* 删除一到多个shell变量（不包括只读变量）。
* 删除一到多个shell函数。
* 删除一到多个具有引用属性的变量（如果-n选项存在）。

## 选项

```
-f：仅删除函数。
-v：仅删除变量（不包括只读变量）。
-n：删除具有引用属性的变量名（如果该选项存在）。
```

## 参数

name（可选）：要删除的变量或函数。

## 返回值

返回成功除非选项错误或要删除的变量或函数有只读属性。

## 例子

```
# 删除变量。
declare paper_size='B5'
unset -v paper_size
```

```
# 删除函数。
function show_result(){ echo 'Last Command Return: $?'; }
unset -f show_result
```

```
# 当不指定选项时，优先删除变量，如果失败则删除函数。
declare -i aa=100
function aa(){ echo 'aa'; }
unset aa
# 变量'aa'已被删除。
declare -p aa
# 函数'aa'存在。
declare -F|grep aa
```

```
# 演示unset使用-n选项，name指定了引用变量时的情况。
declare a=3
# 定义引用变量
declare -n b=a
# 查看属性，显示declare -n b="a"
declare -p b
# 显示3
echo ${b}
# 显示a
echo ${!b}
# 指定-n选项时
unset -n b
# 引用变量b已被删除
declare -p b
# 被引用的变量a未被删除
declare -p a
```

```
# 演示unset不使用-n选项，name指定了引用变量时的情况。
declare a=3
# 定义引用变量
declare -n b=a
# 查看属性，显示declare -n b="a"
declare -p b
# 显示3
echo ${b}
# 显示a
echo ${!b}
# 不指定-n选项时
unset b
# 引用变量b未被删除，显示declare -n b="a"
declare -p b
# 被引用的变量a被删除
declare -p a
```

### 注意

1. 该命令是bash内建命令，相关的帮助信息请查看`help`命令。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hezhiqiang.gitbook.io/linux/ming-ling/unset.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.