{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/249", "result": {"data":{"issuesJson":{"id":"b526fe03-96d0-5c95-ba70-5a581eaa88d2","title":"jenv/jenv: 一个简单的工具，用于多个 JDK 版本的管理与切换","number":249,"bodyHTML":"

\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Repos	jenv/jenv
Views	$\"views\"$
Stars	$\"stars\"$
Forks	$\"forks\"$
License	$\"license\"$
UpdatedAt	$\"last-commit\"$
CreatedAt	$\"create-at\"$

\n\n

\n

\n

\n

Master your Java Environment with jenv

\n

Website : http://www.jenv.be

\n

Maintainers :

\n

Gildas Cuisinier

\n

Future maintainer in discussion:

\n

Benjamin Berman

\n

As he makes an incredible work by taking time to merge the Pull Request on his fork, I (@gcuisinier) am in discussion with him to take part of jEnv directly if he wants.
\nWhatever his decision, I thank him for his work, and to have convincing me to think about the future of jEnv and accepting a new maintainer for the good of the project.

\n

What's jEnv ?

\n

This is an updated fork of jenv, a beloved Java environment manager adapted from rbenv.

\n

jenv gives you a few critical affordances for using java on development machines:

\n

It lets you switch between java versions. This is useful when developing Android applications, which generally require Java 8 for its tools, versus server applications, which use later versions like Java 11.
It sets JAVA_HOME inside your shell, in a way that can be set globally, local to the current working directory or per shell.

\n

However, this project does not:

\n

Install java for you. Use your platform appropriate package manager to install java. On macOS, brew is recommended.

\n

This document will show you how to install jenv, review its most common commands, show example workflows and identify known issues.

\n

Contents

\n

\n

1. Getting Started

\n

Follow the steps below to get a working jenv installation with knowledge of your java environment. Read all the code you execute carefully: a $ symbol at the beginning of a line should be omitted, since it's meant to show you entering a command into your terminal and observing the response after the command.

\n

1.1 Installing `jenv`

\n

On macOS, you can install jEnv using Homebrew:

\n

brew install jenv

\n

Or if you use MacPorts on macOS:

\n

sudo port install jenv

\n

Alternatively, and on Linux, you can install it from source:

\n

git clone https://github.com/jenv/jenv.git ~/.jenv

\n

1.2 Configuring your shell

\n

jEnv needs to be intialised in your shell by evalling the output of jenv init -. e.g.

\n

# Shell: bash\necho 'export PATH=\"$HOME/.jenv/bin:$PATH\"' >> ~/.bash_profile\necho 'eval \"$(jenv init -)\"' >> ~/.bash_profile\n# Shell: zsh\necho 'export PATH=\"$HOME/.jenv/bin:$PATH\"' >> ~/.zshrc\necho 'eval \"$(jenv init -)\"' >> ~/.zshrc

\n

To have JAVA_HOME get set by jEnv, enable the export plugin. This needs to be done in an initialised shell:

\n

eval \"$(jenv init -)\"\njenv enable-plugin export

\n

Restart your shell by closing and reopening your terminal window or running exec $SHELL -l in the current session for the changes to take effect.

\n

exec $SHELL -l

\n

To verify jenv was installed and initialised, run jenv doctor. On a macOS machine, you'll observe the following output:

\n

$ jenv doctor\n[OK]\tNo JAVA_HOME set\n[ERROR]\tJava binary in path is not in the jenv shims.\n[ERROR]\tPlease check your path, or try using `jenv add /path/to/java/home`\n\tPATH : /Users/user/.jenv/libexec:/Users/user/.jenv/shims:/Users/user/.jenv/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin\n[OK]\tJenv is correctly loaded

\n

Observe that jenv is correctly loaded but Java is not yet installed. To rememedy this, see \"Adding Your Java Environment\" below.

\n

Problem? Please visit the Trouble Shooting Wiki page.

\n

Support for fish

\n

Untested: While this fork has improved fish shell support, it has not been tested by this maintainer. To install jenv for Fish according to the contributor's instructions:

\n

echo 'set PATH $HOME/.jenv/bin $PATH' >> ~/.config/fish/config.fish\necho 'status --is-interactive; and jenv init - | source' >> ~/.config/fish/config.fish\ncp ~/.jenv/fish/jenv.fish ~/.config/fish/functions/jenv.fish

\n

1.3 Adding Your Java Environment

\n

Use jenv add to inform jenv where your Java environment is located. jenv does not, by itself, install Java.

\n

For example, on macOS, use brew to install the latest Java (OpenJDK 21, also follow the caveat steps to symlink into the system virtual machines) followed by the appropriate jenv add PATH_TO_JVM_HOME command to recognize it.

\n

brew install java\nsudo ln -sfn /usr/local/opt/openjdk/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk.jdk\njenv add \"$(/usr/libexec/java_home)\" # this will always default to the latest version in /Library/Java/JavaVirtualMachines\n# or\n# jenv add /Library/Java/JavaVirtualMachines/openjdk.jdk

\n

With macOS OpenJDK 21.0.2 installed, for example, either of these commands will add /Library/Java/JavaVirtualMachines/openjdk.jdk/Contents/Home as a valid JVM. Your JVM directory may vary!

\n

Observe now that this version of Java is added to your jenv versions command:

\n

$ jenv versions\n* system (set by /Users/user/.jenv/version)\n  21.0\n  21.0.2\n  openjdk64-21.0.2

\n

By default, the latest version of Java is your system Java on macOS.

\n

We'll now set a jenv local VERSION local Java version for the current working directory. This will create a .java-version file we can check into Git for our projects, and jenv will load it correctly when a shell is started from this directory.

\n

$ jenv local 21.0.2\n$ cat .java-version\n21.0.2

\n

Is JAVA_HOME set?

\n

$ echo ${JAVA_HOME}\n/Users/bberman/.jenv/versions/21.0.2

\n

Yes! Observe that JAVA_HOME is set to a valid shim directory - this is a result of enabling the export plugin.

\n

If you executed this commands inside your $HOME directory, you can now delete .java-version:

\n

jenv local --unset\n# or\nrm .java-version

\n

1.4 Setting Java versions

\n

jenv can set Java versions at 3 levels:

\n

global (lowest priority)
local
shell (highest priority)

\n

Where multiple versions are set, the highest priority setting as above takes effect.

\n

For example if the global version was 17 and the shell version was 11, 11 would be used.

\n

1.4.1 Setting a Global Java Version

\n

Use jenv global VERSION to set a global, default Java version:

\n

jenv global 21.0.2

\n

When you next open a shell or terminal window, this version of Java will be the default.

\n

On macOS, this sets JAVA_HOME for GUI applications on macOS using jenv macos-javahome. Integrates this tutorial to create a file that does not update dynamically depending on what local or shell version of Java is set, only global.

\n

It can be unset with

\n

jenv global --unset

\n

1.4.2 Setting a local Java Version

\n

Use jenv local VERSION to set the Java used in this folder.

\n

This version will activate whenever you cd into the follder. This is useful in the root of projects, for example where you would typically run a
\n./gradlew build or ./mvnw package command from.

\n

jenv local 21.0.2

\n

This can be unset with

\n

jenv local --unset\n# or\nunset .java-version

\n

1.4.3 Setting a Shell Java Version

\n

Use jenv shell VERSION to set the Java used in this particular shell session:

\n

jenv shell 21.0.2

\n

This can be unset with

\n

jenv shell --unset\n# or\nunset JENV_VERSION

\n

2 Common Workflows

\n

These common workflows demonstrate how to use jenv to solve common problems.

\n

2.1 Using Two JVMs on macOS

\n

Our goal is to have both the latest version of Java and JDK 8 installed at the same time. This is helpful for developing Android applications, whose build tools are sensitive to using an exact Java version.

\n

We'll resume where we left off with Java 21.0.2 installed. Let's install Java 8 from brew and symlink it into the Library folder per the caveats.

\n

brew install openjdk@8\nsudo ln -sfn /usr/local/opt/openjdk@8/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-8.jdk

\n

This will install the latest version of Java 8 to a special directory in macOS. Let's see which directory that is:

\n

$ ls -1 /Library/Java/JavaVirtualMachines \nopenjdk-8.jdk\nopenjdk.jdk

\n

Observe the openjdk-8.jdk directory. Your exact version may vary. We cannot retrieve this using /usr/libexec/java_home, unfortunately. We'll add the Java home directory using jenv so that it shows up in our jenv versions command:

\n

$ jenv add /Library/Java/JavaVirtualMachines/openjdk-8.jdk/Contents/Home/\nopenjdk64-1.8.0.222 added\n1.8.0.222 added\n1.8 added\n$ jenv versions\n* system\n  1.8\n  1.8.0.222\n  openjdk64-1.8.0.222\n  21\n  21.0\n  21.0.2\n  openjdk64-21.0.2

\n

2.2 Other Workflows

\n

Please contribute your own using a pull request!

\n

3 Known Issues

\n

Users seem to have issues using jenv with Fish. Please report any here.

","updatedAt":"2025-05-21T16:03:23Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"Version-Switch-Tools","color":"8ff216"}},{"node":{"name":"jenv","color":"d0dd53"}}]},"comments":{"edges":[]}}},"pageContext":{"number":249,"previous":{"title":"jenkinsci/jenkins: Jenkins 是领先的开源自动化服务器。它使用 Java 构建，提供超过 1800 个插件来支持几乎所有事情的自动化，以便人类可以将时间花在机器无法完成的事情上。","number":248},"next":{"title":"unxsist/jet-pilot: 一款 k8s 集群管理客户端，提供资源查看，编辑，日志查看，进入 shell 等能力。","number":250}}}, "staticQueryHashes": ["151096407","2861350382"]}