必须将Tomcat的bin目录加入PATH:先确认解压路径无中文/空格,再编辑~/.zshrc(或~/.bash_profile),添加export CATALINA_HOME、export PATH=$CATALINA_HOME/bin:$PATH和export JAVA_HOME,执行source生效后,即可在任意目录直接运行startup.sh并访问localhost:8080验证。

要在Mac上让终端 anywhere 都能直接运行Tomcat的startup.sh、shutdown.sh等命令,必须把它的bin目录加入系统PATH——否则每次启动都得cd进完整路径,手动执行./startup.sh,极其低效。
确认Tomcat已解压并存放于固定位置
从官网下载.zip包(如apache-tomcat-10.1.33.tar.gz),双击解压后得到一个名为apache-tomcat-10.1.33的文件夹。把它拖进/Users/你的用户名/Software/这类你长期维护的软件目录下,不要放在桌面或Downloads里——路径中【绝对不能含中文、空格或特殊符号】,否则后续所有脚本都会报错退出。
记下这个完整路径,例如:/Users/alex/Software/apache-tomcat-10.1.33
找到并编辑Shell配置文件
Mac Ventura及更新系统默认使用zsh,配置文件是~/.zshrc;若曾手动切回bash,则对应~/.bash_profile。打开终端,执行:
open -e ~/.zshrc
如果提示“No such file”,就用touch ~/.zshrc创建它,再执行上面命令。别用Finder双击打开——那样会失去写入权限,保存失败。
写入CATALINA_HOME和PATH变量
在打开的文本编辑器末尾,逐行粘贴以下三行(注意替换为你自己的实际路径):
export CATALINA_HOME=/Users/alex/Software/apache-tomcat-10.1.33
export PATH=$CATALINA_HOME/bin:$PATH
export JAVA_HOME=$(/usr/libexec/java_home)
这三行缺一不可:第一行声明Tomcat主目录,第二行把bin加进PATH,第三行自动定位系统已装JDK——Tomcat 10+强制要求Java 11+,【若未安装JDK 11或更高版本,此步会静默失败,后续startup.sh运行时直接报错“JAVA_HOME not set”】。
使配置立即生效
回到终端,执行:
source ~/.zshrc
然后验证是否成功:
echo $CATALINA_HOME
应该输出你刚才填的完整路径;再执行:
which startup.sh
应返回 /Users/alex/Software/apache-tomcat-10.1.33/bin/startup.sh ——说明PATH已正确加载。
测试启动与端口访问
在任意目录下,直接输入:
startup.sh
终端将打印日志,最后出现“Server startup in [xxx] ms”。稍等5秒,打开浏览器访问 http://localhost:8080 ——看到Apache Tomcat欢迎页即表示全部配置完成。

















