在 Java 中查找用户主目录的最佳方法是什么？

Question

在 Java 中查找用户主目录的最佳方法是什么？

困难在于解决方案应该是跨平台的； 它应该可以在 Windows 2000、XP、Vista、OS X、Linux 和其他 Unix 变体上运行。 我正在寻找可以在所有平台上完成此操作的代码片段，以及检测平台的方法。

每个 Java bug 4787931，系统属性 user.home 在 Windows XP 上无法正常工作，因此使用此系统属性不是可接受的解决方案，因为它不是跨平台的。

Answer 1

您引用的错误（错误 4787391）已在 Java 8 中修复。即使您使用旧版本的 Java，System.getProperty("user.home") 方法可能仍然是最好的。 user.home 方法似乎在很多情况下都有效。 在 Windows 上实现 100% 无懈可击的解决方案很困难，因为 Windows 对主目录含义的概念发生了变化。

如果 user.home 对您来说不够好，我建议为 Windows 选择一个 home 目录 的定义并使用它，通过 System 获取适当的环境变量.getenv(字符串)。

Answer 2

实际上，对于 Java 8，正确的方法是使用：

System.getProperty("user.home");

错误 JDK-6519127 已修复，并且“ 发行说明的“JDK 8 和 JDK 7 之间的不兼容性”部分指出:

区域：核心库/java.lang

剧情简介

用于确定 Windows 上用户主目录的步骤已更改为遵循 Microsoft 推荐的方法。 这个改变
在旧版本的 Windows 或注册表中可能可以观察到
设置或环境变量设置为其他目录。 自然
不兼容

行为 RFE 

  6519127 
  

尽管这个问题很老，但我还是将其保留以供将来参考

Answer 3

System.getProperty("user.home");

请参阅 JavaDoc。

Answer 4

对于 Windows 来说，HOME 目录的概念似乎有点模糊。 如果环境变量 (HOMEDRIVE/HOMEPATH/ USERPROFILE) 还不够，您可能必须通过 JNI 或 JNA。 SHGetFolderPath 允许您检索特殊文件夹，例如 < em>我的文档 (CSIDL_PERSONAL) 或本地设置\应用程序数据 (CSIDL_LOCAL_APPDATA)。

JNA 代码示例：

public class PrintAppDataDir {

    public static void main(String[] args) {
        if (com.sun.jna.Platform.isWindows()) {
            HWND hwndOwner = null;
            int nFolder = Shell32.CSIDL_LOCAL_APPDATA;
            HANDLE hToken = null;
            int dwFlags = Shell32.SHGFP_TYPE_CURRENT;
            char[] pszPath = new char[Shell32.MAX_PATH];
            int hResult = Shell32.INSTANCE.SHGetFolderPath(hwndOwner, nFolder,
                    hToken, dwFlags, pszPath);
            if (Shell32.S_OK == hResult) {
                String path = new String(pszPath);
                int len = path.indexOf('\0');
                path = path.substring(0, len);
                System.out.println(path);
            } else {
                System.err.println("Error: " + hResult);
            }
        }
    }

    private static Map<String, Object> OPTIONS = new HashMap<String, Object>();
    static {
        OPTIONS.put(Library.OPTION_TYPE_MAPPER, W32APITypeMapper.UNICODE);
        OPTIONS.put(Library.OPTION_FUNCTION_MAPPER,
                W32APIFunctionMapper.UNICODE);
    }

    static class HANDLE extends PointerType implements NativeMapped {
    }

    static class HWND extends HANDLE {
    }

    static interface Shell32 extends Library {

        public static final int MAX_PATH = 260;
        public static final int CSIDL_LOCAL_APPDATA = 0x001c;
        public static final int SHGFP_TYPE_CURRENT = 0;
        public static final int SHGFP_TYPE_DEFAULT = 1;
        public static final int S_OK = 0;

        static Shell32 INSTANCE = (Shell32) Native.loadLibrary("shell32",
                Shell32.class, OPTIONS);

        /**
         * see http://msdn.microsoft.com/en-us/library/bb762181(VS.85).aspx
         * 
         * HRESULT SHGetFolderPath( HWND hwndOwner, int nFolder, HANDLE hToken,
         * DWORD dwFlags, LPTSTR pszPath);
         */
        public int SHGetFolderPath(HWND hwndOwner, int nFolder, HANDLE hToken,
                int dwFlags, char[] pszPath);

    }

}

Answer 5

其他人已经在我之前回答了这个问题，但是打印所有可用属性的有用程序是：

for (Map.Entry<?,?> e : System.getProperties().entrySet()) {
    System.out.println(String.format("%s = %s", e.getKey(), e.getValue())); 
}

Answer 6

另一种方法是使用 Apache CommonsIO FileUtils.getUserDirectory() 而不是 System.getProperty("user.home")。 它会得到相同的结果，并且在指定系统属性时不会出现拼写错误。

您的项目中很可能已经拥有 Apache CommonsIO 库。 如果您打算仅使用它来获取用户主目录，请不要引入它。

Answer 7

当我搜索 Scala 版本时，我只能找到上面 McDowell 的 JNA 代码。 我在这里添加了我的 Scala 端口，因为目前没有更合适的地方。

import com.sun.jna.platform.win32._
object jna {
    def getHome: java.io.File = {
        if (!com.sun.jna.Platform.isWindows()) {
            new java.io.File(System.getProperty("user.home"))
        }
        else {
            val pszPath: Array[Char] = new Array[Char](WinDef.MAX_PATH)
            new java.io.File(Shell32.INSTANCE.SHGetSpecialFolderPath(null, pszPath, ShlObj.CSIDL_MYDOCUMENTS, false) match {
                case true => new String(pszPath.takeWhile(c => c != '\0'))
                case _    => System.getProperty("user.home")
            })
        }
    }
}

与 Java 版本一样，您需要将 Java Native Access 添加到您引用的图书馆。

很高兴看到 JNA 现在使这比发布原始代码时容易得多。

Answer 8

我将使用错误报告中详细介绍的算法，使用 System.getenv(String)，如果没有环境变量指示有效的现有目录，则回退到使用 user.dir 属性。 这应该可以跨平台工作。

我认为，在Windows下，你真正想要的是用户名义上的“文档”目录。

Answer 9

如果你想要在 Windows 上运行良好的东西，有一个名为 WinFoldersJava 的包，它包装了本机调用以获取Windows 上的“特殊”目录。 我们经常使用它并且效果很好。