Tomcat解压即用，核心卡点是JAVA_HOME、CATALINA_HOME配置及端口冲突；需确认JDK 8+正确安装并设好环境变量，解压至无中文无空格路径，修改server.xml端口防冲突，IDE中须统一JRE版本并正确定义Artifact类型。
Tomcat 不是“安装”而是解压即用，JavaWeb 环境的核心卡点从来不是下载按钮，而是 JAVA_HOME、CATALINA_HOME 和端口冲突这三处。
确认 JDK 已正确配置 JAVA_HOME
Tomcat 7 及以后版本只支持 JDK 8+，且必须是 JDK（不是 JRE）。常见错误现象：Cannot find JAVA_HOME 或启动时直接报 UnsupportedClassVersionError。
- 在终端执行
java -version和javac -version，确保二者版本一致且 ≥ 1.8 - 检查
JAVA_HOME是否指向 JDK 根目录（如/Library/Java/JavaVirtualMachines/jdk-11.0.2.jdk/Contents/Home或C:\Program Files\Java\jdk-17），不是bin子目录 - Linux/macOS：在
~/.zshrc或~/.bash_profile中写export JAVA_HOME=/path/to/jdk；Windows：系统环境变量里新增JAVA_HOME，并确保%JAVA_HOME%\bin在PATH前部
解压 Tomcat 并验证 CATALINA_HOME
Tomcat 官网下载的是 zip/tar.gz 归档包，**没有安装程序**。双击或右键解压到无中文、无空格路径（如 /opt/tomcat 或 D:\tomcat）——路径含空格会导致 catalina.sh 启动失败。
- Linux/macOS：给
bin/*.sh加执行权限：chmod +x bin/*.sh - Windows：直接运行
bin\startup.bat；Linux/macOS：运行bin/startup.sh - 启动后访问
http://localhost:8080，看到 Apache Tomcat 首页即成功；若失败，立刻查logs/catalina.out（Linux/macOS）或logs/catalina.<date>.log</date>（Windows） -
CATALINA_HOME是可选环境变量，但建议设置：它明确告诉 Tomcat 自己在哪，避免多实例混乱；值 = Tomcat 解压后的根目录
修改默认端口与部署 Web 应用
8080 端口被占用是第二高发问题（常见于 Skype、其他 Java 进程）。不改端口就无法启动，错误日志里会明确提示 Address already in use。
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
立即学习“Java免费学习笔记（深入）”；
- 编辑
conf/server.xml，找到<connector port="8080" ...></connector>，改为port="8081"或其他可用端口 - 部署方式有两种：直接把打包好的
.war文件丢进webapps/目录（Tomcat 会自动解压）；或把解压后的应用目录（如myapp/）整个放进去 - 注意：如果应用名是
ROOT.war，它会覆盖默认首页；若想通过http://localhost:8080/直接访问你的应用，就得用这个名字 - 热部署慎用：开发阶段可开
autoDeploy="true"，但生产环境务必关掉，否则文件系统监听可能引发安全或性能问题
IDE（如 IntelliJ IDEA / Eclipse）中关联 Tomcat
IDE 内置的 “Add Configuration → Tomcat Server” 功能，本质是复用你本地已解压的 Tomcat，**不是重新安装一个**。容易踩坑的是路径和 JRE 设置。
- 在 IDE 中指定
Application server路径时，必须指向 Tomcat 解压根目录（即含bin/、conf/、webapps/的那个文件夹） - Deployment 选项卡里添加的 Artifact，要选对类型：是
exploded（开发调试用）还是war exploded（更贴近真实部署结构） - 关键细节：IDE 启动 Tomcat 时使用的 JRE，必须和你系统级
JAVA_HOME一致，否则编译用 JDK 17、运行用 JRE 8，照样抛UnsupportedClassVersionError - IDE 控制台输出若显示
INFO [main] org.apache.catalina.startup.Catalina.start Server startup in [xxx] ms才算真正跑起来了，别只看控制台没报错就以为成功
真正让 JavaWeb 环境跑起来的，从来不是点击下载链接那一刻，而是你在终端敲出 echo $JAVA_HOME 看到正确路径、在 server.xml 里改完端口后 curl 通了 localhost:8081、以及在 IDE 的 Deployment 配置里看清 Artifact 类型的那一瞬间——这些地方，错一个，后面全卡住。
