如何调试 Java 开源项目源码，记一种源码导入开发工具并调试的通用方法

楔子

说起读开源项目源码，很多朋友觉得高大上、大佬牛逼，云云~

挡在很多人面前的不是源码怎么读，而是不知道如何导入源码到开发工具以及如何调试源码。

本文将以 spring-cloud-gateway 源码导入一个简单的 SpringBoot 项目中举例，目的就是给读者一个导入开源项目源码并调试的简单方法。

看文过程中感觉有不明白的地方欢迎评论留言，如果本文帮到了你，本人不胜荣幸的同时，也欢迎为本文点个大拇哥 😅

准备工作

1、默认大家本地有装 IDEA、Maven、Git，Java 程序员通识就不再细述。

2、下载源码 https://github.com/spring-cloud/spring-cloud-gateway.git

3、切换 tag 创建分支 v3.0.2

本例中切换分支有其原因：根据BOM spring-cloud-dependencies-parent 中定义的版本对应的仓库tag 正是v3.0.2

4、使用 https://start.spring.io/ 初始化一个demo，引入 spring-cloud-starter-gateway依赖，使用Java 8，项目名等其他信息默认

点击 GENERATE 下载生成的代码压缩包，解压到自己的目录

5、目前 demo 与 spring-cloud-gateway 源码都放到了 ~/WorkSpace/gitRepo 目录下了。

接下来，开始导入项目与源码

导入项目与源码

1、导入demo工程

给出一下demo的pom.xml：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>2.4.4</version>
		<relativePath/> <!-- lookup parent from repository -->
	</parent>
	<groupId>com.example</groupId>
	<artifactId>demo</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<name>demo</name>
	<description>Demo project for Spring Boot</description>
	<properties>
		<java.version>1.8</java.version>
		<spring-cloud.version>2020.0.2</spring-cloud.version>
	</properties>
	<dependencies>
		<dependency>
			<groupId>org.springframework.cloud</groupId>
			<artifactId>spring-cloud-starter-gateway</artifactId>
		</dependency>
 
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
	</dependencies>
	<dependencyManagement>
		<dependencies>
			<dependency>
				<groupId>org.springframework.cloud</groupId>
				<artifactId>spring-cloud-dependencies</artifactId>
				<version>${spring-cloud.version}</version>
				<type>pom</type>
				<scope>import</scope>
			</dependency>
		</dependencies>
	</dependencyManagement>
 
	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
		</plugins>
	</build>
 
</project>

2、检查 gateway 相关依赖是否引入

直接输入关键字，搜索 gateway，查看是否有gateway相关依赖，这是我们一般引Maven依赖的方式。

3、引入 spring-cloud-gateway 源码工程

使用 spring-cloud-gateway 下的pom.xml 引入项目

等待依赖拉取完成，如下图所示

验证

1、验证External Libraries 下是否仍有 spring-cloud-starter-gateway 依赖

直接用搜索关键字来查

2、修改 spring-cloud-gateway 子工程源码，测试demo是否使用spring-cloud-gateway源码工程

把demo工程run起来，什么也不需要配置，直接看日志输出

如上图，当前依赖的是源码了，可以放心的加注释与Debug了。

原理

这个方法是利用了Maven依赖搜索顺序做到的。

源码依赖 > 本地仓库依赖 > 远程仓库依赖

ps：Gradle也是类似的

详细解释就是引入 spring-cloud-gateway 的 pom.xml时，会连带着将其子工程均依赖到当前工作空间中，对于 Maven 而言，这几个子工程的pom.xml是它首先要搜索的地方，这些pom.xml正是定义坐标的地方。

当Maven按demo工程的pom找坐标时，会按下图的坐标到所有引进来的工程中先找上一波

当找到spring-cloud-gateway源码工程时，发现还有子工程，再到子工程找一遍

找到 spring-cloud-starter-gateway 工程的pom.xml时，就会将其源码依赖进来

由于SpringBoot 和 SpringCloud 的 Starter 都是虚包，spring-cloud-starter-gateway 会把其他相关依赖引到项目中。

后话

写这篇文章做个记录，希望能帮到有需要的人，如果本文对你有所启发，点个推荐再走呗~

我是 Hellxz，一个Java/Vue/K8s/DevOps等涉猎广泛的软件工程师！

细水长流，我们下次再见，peace~

---

本文同步发布于我的CSDN博客 https://blog.csdn.net/u012586326?spm=1001.2101.3001.5343