Maven dependency analysis and conflict detection tool, support dependency tree display, dependency path display, dependency conflict detection, dependency exclusion, etc.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
A professional Maven dependency analysis tool, designed to fill a gap in the VSCode ecosystem and significantly boost your development efficiency.
In a VSCode environment that lacks a native and powerful Maven dependency management tool, Maven Helper provides an intuitive dependency tree and professional conflict detection to help you easily manage complex project dependencies.
Free vs. Pro
Maven Helper offers a free version with essential features and a Pro subscription version with enhanced capabilities. Your subscription is the greatest support for the continuous development of this project!
Search for "Maven Helper" in the VSCode Extension Marketplace and click Install.
2. Prerequisites & Configuration (Important)
Correctly configuring the environment is key to ensuring the extension works properly and is the most common source of issues.
Java Environment: Ensure the JAVA_HOME environment variable is set correctly and points to your JDK directory.
Maven for Java Extension: It is highly recommended to install this official extension. Maven Helper will attempt to retrieve Maven configurations from it.
Manual Configuration (if needed): If the extension cannot find your Maven installation automatically, or if you need to use a specific configuration, add the following to your VSCode settings.json:
"maven.executable.path": "/path/to/your/mvn", // must end mvn
"maven.settingsFile": "/path/to/your/settings.xml" // must end .xml
3. Usage
Open a Maven project containing a pom.xml file.
Find and click the "Maven Helper" icon in the left Activity Bar.
The panel will display your projects; click on a project to start the analysis.
4. Frequently Asked Questions (FAQ)
Q: Port is in use when upgrading to Pro?
A: This happens because the port used for authentication (default 7891) is occupied by another application (e.g., a proxy tool like Clash). Please close the conflicting application, or kill the corresponding process via Task Manager / command line, and then try the authentication again.
Configuration Options
maven-helper.dependency.showGroupId: (boolean, defaults to false)
Controls whether to show the GroupID in the dependency tree.
maven-helper.log.debug: (boolean, defaults to false)
Controls whether to print detailed debug logs in the "Output" panel.
maven-helper.maven.useNativeDependencyTree: (boolean, defaults to false)
Controls the dependency analysis execution mode.
false (default): Uses the faster depgraph plugin for analysis.
true: Switches to the native dependency:tree -Dverbose command. Try this option if the depgraph mode encounters issues.
