修改 Windows Hosts 檔案：將 localhost 映射為自訂網域

前言

在本地開發測試時，常希望用有意義的網域名（如 myproject.local、api.test）取代 localhost 或 127.0.0.1，方便區分多專案、測試 Cookie 跨網域行為或模擬正式環境。最簡單的方法是編輯 Windows hosts 檔案，將自訂網域指向本機 IP。本文說明操作步驟與注意事項。

操作步驟

1. 按 Win + R 開啟「執行」對話框。
2. 輸入 drivers 按 Enter，開啟 C:\Windows\System32\drivers 目錄。
3. 進入 etc 子目錄，找到 hosts 檔案（無副檔名）。
4. 以系統管理員身分開啟記事本（右鍵記事本 → 「以系統管理員身分執行」），拖曳 hosts 進入記事本編輯。
5. 在檔案末尾新增一行：
   127.0.0.1 myproject.local
   （IP 與網域以 Tab 或空格分隔，可新增多行）
6. 儲存檔案（Ctrl + S）。

立即生效驗證

Windows 會即時讀取 hosts，無需重啟網路服務。開啟命令提示字元測試：

ping myproject.local

應回覆 127.0.0.1。瀏覽器輸入 https://myproject.local 即可存取本機 Web 服務。

常見應用場景

• 多專案並行：127.0.0.1 frontend.local api.local admin.local
• 測試子網域 Cookie：127.0.0.1 app.example.com sso.example.com
• 模擬正式環境網域：127.0.0.1 www.mycompany.com（需注意瀏覽器 HSTS 快取）
• 封鎖特定網站：127.0.0.1 ads.annoying.com

注意事項與疑難排解

1. 權限不足無法儲存

必須以「系統管理員身分」開啟編輯器，否則儲存時會提示「拒絕存取」。

2. 防毒軟體攔截

部分防毒軟體（如 360、卡巴斯基）會保護 hosts 防止惡意軟體竄改，需暫時關閉保護或加入信任名單。

3. DNS 快取導致不生效

若修改後仍解析舊 IP，執行 ipconfig /flushdns 清除本機 DNS 快取。

4. 編碼格式

hosts 檔案應以 ANSI/UTF-8 無 BOM 編碼儲存，避免中文註解導致解析異常。

5. IPv6 環境

若系統啟用 IPv6，建議同時加入 ::1 myproject.local。

進階：搭配虛擬主機

修改 hosts 只是解析端，Web 伺服器（Apache/Nginx/IIS）仍需設定虛擬主機 對應網域：

# Apache 範例 (httpd-vhosts.conf)
<VirtualHost *:80>
    ServerName myproject.local
    DocumentRoot "C:/projects/myproject/public"
    <Directory "C:/projects/myproject/public">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

總結

編輯 hosts 是本地開發最輕量的網域映射方式，無需架設 DNS 伺服器。掌握「以管理員身分編輯、清除 DNS 快取、搭配虛擬主機」三步驟，即可建立彈性、直覺的本地開發環境。