Tomcat是Java Web开发中最常用的Servlet容器之一，在Mac上使用它时，正确配置路径和环境变量是绕不开的一步。不少新手把Tomcat解压到某个目录后，直接在终端输入startup.sh，结果提示command not found，或者明明文件就在那里却提示Permission denied。这些问题的根源，大多和路径配置、环境变量以及脚本权限有关。本文将从零开始，完整演示Mac下配置Tomcat路径的全过程，并把常见的坑逐一说明。
一、下载Tomcat并确认安装目录
首先去Apache Tomcat官网下载压缩包，建议选择tar.gz格式。下载完成后，通常需要把它解压到一个规范的位置。Mac上常见的做法是放在用户目录下的Library目录中，例如/Users/你的用户名/Library/Tomcat，也可以放到/usr/local下。不建议直接放在下载文件夹里，因为路径中一旦包含中文或空格，后续配置环境变量时很容易出问题。
解压可以使用归档工具双击完成，也可以在终端用命令操作：
cd ~/Downloads tar -zxvf apache-tomcat-9.0.xx.tar.gz sudo mv apache-tomcat-9.0.xx ~/Library/Tomcat
解压并移动完成后，一定要记住这个完整路径，因为接下来配置环境变量时要用到它。可以用pwd命令确认当前目录，也可以在Finder中右键文件夹选择显示简介查看完整路径。确认路径这一步看似简单，却是后面所有配置的基础，路径写错一个字母，环境变量就会失效。
二、配置CATALINA_HOME环境变量
环境变量的作用是让系统在任何目录下都能找到Tomcat。从macOS Catalina开始，系统默认的Shell是zsh，因此需要编辑用户主目录下的.zshrc文件。如果你的机器还在使用bash，则对应编辑.bash_profile文件。打开终端，执行以下命令：
vim ~/.zshrc
在文件末尾添加如下内容，注意把路径替换成你自己的实际安装路径：
export CATALINA_HOME=/Users/你的用户名/Library/Tomcat export PATH=$PATH:$CATALINA_HOME/bin
第一行定义了CATALINA_HOME变量，它指向Tomcat的根目录，很多启动脚本内部会依赖这个变量来定位自己的位置。第二行把Tomcat的bin目录追加到系统的PATH变量中，这样无论你当前处于哪个目录，都可以直接输入startup.sh来启动Tomcat。
保存退出后，有一个极其关键的动作：必须执行source命令让配置立即生效，否则新开的配置只会在下一个终端窗口才被加载：
source ~/.zshrc echo $CATALINA_HOME
如果echo命令能正确输出你的Tomcat路径，说明环境变量已经配置成功。这一步是验证配置是否生效最直接的手段，建议每次修改配置文件后都执行一次。
三、赋予脚本执行权限并启动验证
从网上下载的压缩包解压后，bin目录下的脚本文件有时并不具备可执行权限，直接运行会报Permission denied。解决方法是用chmod命令为所有sh脚本添加执行权限：
sudo chmod +x $CATALINA_HOME/bin/*.sh
权限设置完成后，就可以启动Tomcat了：
startup.sh
看到终端输出Tomcat started之类的提示后，打开浏览器访问http://127.0.0.1:8080，如果能看到Tomcat的经典欢迎页面，说明整个配置流程已经成功。关闭Tomcat使用shutdown.sh命令即可。如果想要更详细的启动日志观察方式，也可以使用catalina.sh run，它会在前台运行并把日志直接打印到终端，方便排查启动失败的原因。
四、新手最容易踩的几个坑
第一个坑是变量名拼写错误。CATALINA_HOME必须全部大写且拼写正确，写成catalina_home或CATALINAHOME都不会生效，而且不会有任何报错提示，非常隐蔽。第二个坑是忘记source，改完配置文件以为万事大吉，结果当前终端里变量还是空的。第三个坑是路径包含空格或中文，zsh中带空格的路径必须用引号包裹或转义，新手很容易处理不当。
第四个常见的坑是JAVA_HOME没有配置。Tomcat是Java应用，启动时依赖JDK。如果终端提示找不到JAVA_HOME或者版本过低，需要先安装JDK并配置好JAVA_HOME环境变量，再回来启动Tomcat。可以在终端用java -version确认Java环境是否正常。第五个坑是端口被占用，8080端口如果被其他程序占用，Tomcat会启动失败，可以在conf/server.xml中修改Connector的port属性，换一个未被占用的端口。
最后一个容易忽略的问题是权限不足。如果把Tomcat放在了系统目录如/usr/local下，普通用户身份写入日志或修改配置可能受限，建议用sudo chown -R 你的用户名 $CATALINA_HOME把目录所有者改成自己，避免后续操作反复碰到权限报错。只要避开以上这些坑，在Mac上配置和使用Tomcat就会非常顺畅。
Mac配置Tomcat路径Tomcat环境变量CATALINA_HOME修改时间：2026-09-02 17:18:45