IntelliJ IDEA 中為 JVM 啟動(dòng)設(shè)置禁用代理，通常有兩種核心場(chǎng)景：

• 一是解決 IDEA 內(nèi)置工具（如 REST Client）因代理問(wèn)題導(dǎo)致的網(wǎng)絡(luò)超時(shí)；
• 二是解決 IDEA 本身或其啟動(dòng)的項(xiàng)目因代理配置錯(cuò)誤而無(wú)法啟動(dòng)或連接失敗的問(wèn)題。

禁用代理的本質(zhì)是不讓 JVM 進(jìn)程使用任何 HTTP/HTTPS/SOCKS 代理進(jìn)行網(wǎng)絡(luò)通信，這可以通過(guò)配置特定的 JVM 參數(shù)來(lái)實(shí)現(xiàn) 。

一、問(wèn)題解構(gòu)：為何需要禁用代理？

二、方案推演：如何設(shè)置 JVM 啟動(dòng)參數(shù)以禁用代理？

禁用代理并非在某個(gè)配置文件中勾選“不使用代理”，而是通過(guò)向 JVM 傳遞特定的系統(tǒng)屬性（System Properties），明確指示其繞過(guò)代理。主要方法如下：

方法 1：在 項(xiàng)目運(yùn)行/調(diào)試配置 中設(shè)置（針對(duì)具體應(yīng)用）

此方法只影響當(dāng)前選定的運(yùn)行配置，最為常用和精準(zhǔn)。

• 打開(kāi)運(yùn)行配置：點(diǎn)擊 IDEA 主界面右上角運(yùn)行配置下拉菜單，選擇 Edit Configurations...。
• 在 Build and run 或 Configuration 標(biāo)簽頁(yè)中，找到 VM options 輸入框。

添加以下 JVM 參數(shù)：

-DproxySet=false -Dhttp.proxyHost= -Dhttp.proxyPort= -Dhttps.proxyHost= -Dhttps.proxyPort= -DsocksProxyHost= -DsocksProxyPort=

關(guān)鍵說(shuō)明：

• -DproxySet=false：明確告知 JVM 不啟用代理。
• 將 proxyHost 和 proxyPort 等相關(guān)屬性設(shè)置為空值，是為了覆蓋任何可能被默認(rèn)設(shè)置的代理配置 。

應(yīng)用并運(yùn)行：保存配置后，以此配置啟動(dòng)的應(yīng)用其 JVM 將不會(huì)使用任何代理。

方法 2：在 IDE 的 VM 選項(xiàng)文件 中設(shè)置（影響整個(gè) IDEA 及所有由其啟動(dòng)的默認(rèn)進(jìn)程）

此方法修改的是 IDEA 自身啟動(dòng)時(shí)的 JVM 參數(shù)，影響范圍廣，需謹(jǐn)慎。

定位 VM 選項(xiàng)文件：

• 當(dāng)前項(xiàng)目配置：<你的項(xiàng)目目錄>/.idea/idea64.exe.vmoptions (如果存在)。

全局 IDE 配置：

• Windows: %USERPROFILE%\AppData\Roaming\JetBrains\<IntelliJ IDEA版本>\idea64.exe.vmoptions
• macOS: ~/Library/Application Support/JetBrains/<IntelliJ IDEA版本>/idea64.exe.vmoptions
• Linux: ~/.config/JetBrains/<IntelliJ IDEA版本>/idea64.exe.vmoptions

編輯文件：用文本編輯器打開(kāi)對(duì)應(yīng)的 vmoptions 文件，在末尾添加與方法 1 相同的禁用代理參數(shù)行。

-DproxySet=false
-Dhttp.proxyHost=
-Dhttps.proxyHost=
-DsocksProxyHost=
# 可根據(jù)需要補(bǔ)充其他代理端口設(shè)置為空

重啟 IDEA：修改此文件后，必須完全關(guān)閉并重啟 IntelliJ IDEA 才能使配置生效 。重啟后，IDEA 主進(jìn)程及其默認(rèn)上下文創(chuàng)建的子進(jìn)程將禁用代理。

方法 3：通過(guò) 環(huán)境變量 傳遞（系統(tǒng)級(jí)或會(huì)話級(jí)）

在啟動(dòng) IDEA 或運(yùn)行項(xiàng)目的 shell 中設(shè)置 JAVA_TOOL_OPTIONS 或 _JAVA_OPTIONS 環(huán)境變量。這種方法具有傳遞性，會(huì)被所有在該環(huán)境中啟動(dòng)的 JVM 讀取。

# 在終端中設(shè)置環(huán)境變量后啟動(dòng)IDEA (Linux/macOS示例)
export JAVA_TOOL_OPTIONS="-DproxySet=false -Dhttp.proxyHost= -Dhttps.proxyHost="
open /Applications/IntelliJ\ IDEA.app

# 或者直接在運(yùn)行命令前設(shè)置 (Windows cmd示例)
set JAVA_TOOL_OPTIONS=-DproxySet=false -Dhttp.proxyHost= -Dhttps.proxyHost=
idea64.exe

三、驗(yàn)證與排查

設(shè)置完成后，可以通過(guò)以下方式驗(yàn)證代理是否已禁用：

在應(yīng)用程序代碼中打印系統(tǒng)屬性：

public class ProxyCheck {
    public static void main(String[] args) {
        System.out.println("http.proxyHost: " + System.getProperty("http.proxyHost"));
        System.out.println("proxySet: " + System.getProperty("proxySet"));
        // 輸出應(yīng)為空或false
    }
}

運(yùn)行上述代碼，如果輸出中 http.proxyHost 為 null 且 proxySet 為 false，則證明代理已禁用。

• 檢查網(wǎng)絡(luò)請(qǐng)求：使用 IDEA 的 REST Client 或運(yùn)行一個(gè)簡(jiǎn)單的 HTTP 請(qǐng)求程序，觀察是否仍存在超時(shí)。如果問(wèn)題解決，說(shuō)明配置生效 。
• 查看啟動(dòng)日志：對(duì)于 IDEA 啟動(dòng)問(wèn)題，可以查看 IDEA 的日志文件（位于 Help -> Show Log in Finder/Explorer），搜索 “proxy” 關(guān)鍵詞，檢查是否有代理相關(guān)的錯(cuò)誤信息 。

四、進(jìn)階實(shí)踐與注意事項(xiàng)

• 與 Maven/Gradle 代理的關(guān)系：上述 JVM 參數(shù)主要控制 Java 應(yīng)用程序的運(yùn)行時(shí)網(wǎng)絡(luò)行為。Maven/Gradle 等構(gòu)建工具有其獨(dú)立的代理配置（settings.xml 或 gradle.properties）。禁用 JVM 代理不會(huì)自動(dòng)禁用構(gòu)建工具的代理。若需禁用，需在其各自的配置文件中進(jìn)行相應(yīng)設(shè)置 。
• 區(qū)分 IDE 代理與 JVM 代理：務(wù)必理解，在 Settings -> HTTP Proxy 中設(shè)置的代理和通過(guò) JVM 參數(shù) -DproxyHost 設(shè)置的代理是兩套不同系統(tǒng)。前者用于 IDE 自身，后者用于程序。因此，在程序出現(xiàn)代理問(wèn)題時(shí)，應(yīng)優(yōu)先檢查并調(diào)整 JVM 參數(shù)，而不是 IDE 的代理設(shè)置 。
• Docker 或容器環(huán)境：如果在 IDEA 中運(yùn)行 Docker 容器，代理禁用需要在容器內(nèi)部的 JVM 環(huán)境中配置，或者在 Docker run 命令中傳遞相應(yīng)的環(huán)境變量。
• 選擇性禁用：如果只是部分地址不需要代理（如內(nèi)網(wǎng)地址），可以配置 -Dhttp.nonProxyHosts 參數(shù)，而非完全禁用。例如：-Dhttp.nonProxyHosts="localhost|127.*|192.168.*|*.internal" 。

五、總結(jié)

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

最新評(píng)論