环境变量与 Shell 配置入门

举报
yd_220055865 发表于 2026/11/16 15:39:35 2026/11/16
【摘要】 很多刚接触 Linux 的新手都会遇到一类问题:明明装好了某个命令行工具,终端却提示 command not found;明明在配置文件里写了 export,重新打开终端后又失效了;同一条命令,在自己的终端里能用,换一个终端、换一个用户就用不了。这些问题大多不是工具本身坏了,而是环境变量和 Shell 配置没有理顺。本文把最常用的概念、文件和排查方法一次讲清楚,适合刚开始用 Bash 或 Z...

很多刚接触 Linux 的新手都会遇到一类问题:明明装好了某个命令行工具,终端却提示 command not found;明明在配置文件里写了 export,重新打开终端后又失效了;同一条命令,在自己的终端里能用,换一个终端、换一个用户就用不了。这些问题大多不是工具本身坏了,而是环境变量和 Shell 配置没有理顺。本文把最常用的概念、文件和排查方法一次讲清楚,适合刚开始用 Bash 或 Zsh 的读者。

一、环境变量是什么

环境变量是 Shell 和程序共享的一组“键值对”,用来告诉程序到哪里找文件、用什么语言、家目录在哪里,等等。每个变量有一个名字和一个值,名字通常全部大写。

常见的环境变量有:

  • PATH:Shell 查找可执行文件的目录列表。
  • HOME:当前用户的家目录。
  • USER:当前用户名。
  • SHELL:当前使用的 Shell 程序。
  • LANG:语言和字符编码设置。
  • EDITOR:默认文本编辑器。

查看一个变量的值,可以用 echo,变量名前加 $:

echo $HOME
echo $PATH

查看全部环境变量,可以用 printenv;只查看 Shell 变量(包括没有导出的变量),可以用 set。如果一个名字没有定义,echo $名字 会输出空行,这本身也是一种排查信号。

二、临时设置与永久设置

在终端里用 export 设置的变量,只对当前这个 Shell 会话及其子进程有效:

export MY_APP_HOME=/opt/myapp
export PATH=$PATH:/opt/myapp/bin

关闭终端、重新打开后,这些设置就消失了。想让设置长期生效,需要把同样的 export 语句写进 Shell 的启动配置文件里,然后重新打开终端,或者在当前终端执行 source 重新加载配置文件:

source ~/.bashrc

理解“临时”和“永久”的区别,是排查“刚才还好好的,怎么又不行了”的第一步。

三、PATH 是最常用的环境变量

PATH 是一个用冒号分隔的目录列表。输入一个命令时,Shell 会按 PATH 里的顺序,依次在这些目录中查找同名的可执行文件,找到第一个就执行。

查看 PATH 时,建议把它按冒号换行打印出来,读起来更清楚:

echo $PATH | tr ':' '\n'

往 PATH 里加目录时,要注意三点。第一,不要直接把原值丢掉,正确写法是在原值后面追加:export PATH=$PATH:/新目录。第二,如果目录里有空格,路径要加引号。第三,顺序有意义:排在前面的目录优先级更高,同名命令会优先使用前面的版本。

查看某个命令到底用的是哪一个,可以用 which 或 type:

which python3
type python3

四、Shell 启动时到底读了哪些文件

这是最容易混淆的地方。Shell 分为登录 Shell 和非登录 Shell、交互式和非交互式,不同情况读取的文件不同。以最常见的 Bash 为例:

  • 登录 Shell:先读 /etc/profile,再依次尝试 ~/.bash_profile、~/.bash_login、~/.profile,找到第一个存在的文件就读它。
  • 交互式非登录 Shell:读 ~/.bashrc。
  • Zsh:登录 Shell 读 ~/.zprofile,交互式 Shell 读 ~/.zshrc。

很多发行版会在 ~/.bash_profile 里加上一句“如果 ~/.bashrc 存在就加载它”,这样登录 Shell 也能用上 ~/.bashrc 里的配置。如果你的系统没有这句,就会出现“图形终端里好好的,SSH 登录后配置没了”之类的现象。

一个简单实用的做法是:把别名、提示符、PATH 追加这类日常配置放在 ~/.bashrc(Bash)或 ~/.zshrc(Zsh)里;把只在登录时需要执行一次的设置放在 ~/.bash_profile 或 ~/.zprofile 里。

五、写一份干净的配置文件

下面是一份思路清晰的 ~/.bashrc 片段示例,路径请按自己机器上的实际安装位置替换,不要照抄:

# 常用工具的安装目录
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
export PATH=$JAVA_HOME/bin:$PATH

# 自己写的脚本目录
export PATH=$HOME/bin:$PATH

# 常用别名
alias ll='ls -l'
alias grep='grep --color=auto'

# 让命令行历史记录更大一些
export HISTSIZE=10000
export HISTFILESIZE=10000

写配置时建议遵守几个习惯:每类设置加一行注释,说明它用来做什么;同一类设置放在一起;不要在配置文件里写删除文件、格式化磁盘这类危险命令;改完先用 bash -n ~/.bashrc 检查语法,再 source 加载。

如果不确定当前用的是 Bash 还是 Zsh,先执行 echo $SHELL 确认,再决定改哪一个文件。改错文件是新手最常见的无效操作。

六、项目里的 .env 文件

很多项目会在项目目录下放一个 .env 文件,用来保存该项目需要的环境变量,例如服务地址、端口、调试开关。.env 文件本身不会被 Shell 自动读取,通常由程序启动时加载,或者用 export $(cat .env) 这类方式手动加载。

使用 .env 时要记住:不要把密码、密钥、Token 写进 .env 后又提交到代码仓库;.env 文件应当加入版本控制的忽略列表,只提交一份不含真实敏感信息的 .env.example 作为模板。

七、常见问题排查

遇到环境变量不生效时,可以按下面的顺序检查:

  1. 确认变量名拼写正确,Linux 的环境变量名区分大小写,Path 和 PATH 不是同一个变量。
  2. 确认写了 export。只写 MY_VAR=1 而不 export,子进程是看不到它的。
  3. 确认改对了文件。先用 echo $SHELL 确认 Shell,再确认该 Shell 会读取的文件。
  4. 确认已经重新加载。改完配置文件后,要重新打开终端,或者执行 source ~/.bashrc。
  5. 确认没有被后面的语句覆盖。配置文件是按顺序执行的,后面的赋值会覆盖前面的。
  6. 确认子 Shell 的问题。在脚本里设置的变量,脚本结束后就消失了;需要影响当前 Shell 时,要用 source 脚本名 而不是直接执行脚本。
  7. 确认 sudo 的问题。sudo 默认会使用一套更干净的环境变量,普通用户的 PATH 不一定能带过去。

另外,配置文件里的一处语法错误可能导致后面的内容都不执行,改完后先检查语法,再加载,是一个值得养成的好习惯。

八、总结与检查清单

  • 环境变量是程序共享的键值对,PATH 决定 Shell 在哪些目录找命令。
  • export 只对当前会话有效,写进启动配置文件才能长期生效。
  • 登录 Shell 和交互 Shell 读取的文件不同,改配置前先确认 Shell 类型。
  • PATH 追加时保留原值,注意顺序和引号。
  • 配置文件分段写、加注释,改完检查语法再加载。
  • 敏感信息不要写进会提交到仓库的文件里。

把这些概念理顺之后,再遇到 command not found、配置改了不生效、换个终端就失效的问题,就能先看变量、再看文件、最后看加载顺序,一步步定位,而不是反复重装工具。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。