跳到主要內容

【GitHub教學】Git push 卡住沒反應?3 步驟解決 SSH 上傳與密碼設定問題

剛開始學寫程式、準備把人生第一個專案上傳到 GitHub 時,常常會遇到一個大魔王:「身份驗證」。很多新手會直覺地想把帳號密碼寫在專案的設定檔裡,但請千萬記住:這非常不安全!GitHub 其實是透過您電腦中的「SSH 金鑰對」(就像是專屬於你電腦的 VIP 通行證)來進行安全連線的。今天這篇保姆級教學,將帶你一步步設定 SSH 公鑰,並順利解決背景上傳卡住的痛點,讓你一次通關,告別密碼地獄!

 

 

1. 為什麼不要把密碼寫在專案裡?

想像一下,如果把家門鑰匙直接黏在門把上,那鎖還有意義嗎?在開發軟體時,如果我們將帳號與密碼直接寫在設定檔或程式碼中,一旦專案公開或是被其他人拷貝,您的帳號安全就等於完全裸奔了。因此,現代開發流程中,不需要(也不應該)將任何帳號或密碼硬編碼寫入專案檔案裡。取而代之的,是使用極度安全的「SSH 金鑰對」認證機制。

2. 步驟一:將電腦的 SSH 公鑰交給 GitHub

要把電腦裡的專案推送到 GitHub,我們得先讓 GitHub 認識你的電腦。我們需要把電腦裡的「公鑰」註冊進去,設定非常簡單:

💡 加碼教學:如何找到並複製我電腦的公鑰?

請打開您電腦的終端機(Mac 為 Terminal / Windows 為 PowerShell),輸入以下指令來複製:

🍎 Mac / Linux 使用者:請輸入 cat ~/.ssh/id_rsa.pub | pbcopycat ~/.ssh/id_ed25519.pub | pbcopy 然後按 Enter。此時公鑰已經自動複製到剪貼簿囉!
🪟 Windows 使用者:請輸入 clip < ~/.ssh/id_rsa.pubclip < ~/.ssh/id_ed25519.pub 然後按 Enter。

⚠️ 終端機顯示「No such file or directory」找不到檔案?
別慌!這代表您的電腦是第一次設定,還沒有這把鑰匙。我們來手動打一把,請在終端機輸入(請將信箱換成您的註冊信箱):

ssh-keygen -t ed25519 -C "您的信箱@gmail.com"

接著終端機會問你存放路徑和密碼,請什麼都不要輸入,直接「連續按下 3 次 Enter 鍵」到底(代表使用預設值且不設密碼,這能避免後續上傳卡關)。看到一個奇怪的方塊圖案後就成功了!此時請再執行一次上面複製公鑰的指令即可。

  1. 打開瀏覽器,登入您的 GitHub 帳號。
  2. 點擊右上角的大頭貼,在下拉選單中找到並點擊 Settings(設定)
  3. 在左側選單中,找到 SSH and GPG keys 並點擊進入。
  4. 點擊右上角的綠色按鈕 New SSH key
  5. Title(標題):可以隨便填,建議填寫能清楚辨識這台電腦的名稱,例如:My Mac M2 或是 工作用筆電
  6. Key(金鑰內容):將剛剛用終端機複製好的公鑰代碼,完整貼入大框框裡。
  7. 點擊 Add SSH key 儲存。恭喜!GitHub 現在已經認得你的專屬電腦了。

3. 踩坑預警:為什麼軟體背景上傳總是卡住?

很多新手興沖沖設定好公鑰後,回到常用的編輯器(例如 VS Code)或圖形化介面軟體點擊上傳按鈕,卻發現進度條卡住一動也不動!到底是哪裡出錯了呢?

💡 關鍵原因解密:因為當我們在背景執行 git push 上傳時,如果您的 SSH 金鑰當初有設定密碼 (Passphrase),或者這是您的電腦第一次連線該 GitHub 倉庫,終端機會在背景跳出安全提示,詢問您 Are you sure you want to continue connecting (yes/no/[fingerprint])?。因為背景程式無法像真人一樣輸入「yes」或「密碼」,它就會一直傻傻地卡在等待輸入的狀態中,無限期罷工!

4. 步驟二:在終端機手動執行第一次推送 (破除卡關)

為了解決這個卡住的問題,最簡單且一勞永逸的解法,就是由您親自在電腦的終端機 (Terminal) 手動執行一次推送。只要手動成功解鎖過這一次,未來的連線就會順暢無阻!請打開 Mac 上的「終端機」,跟著以下指令無腦操作:

Step 1. 切換到發佈資料夾

請輸入 cd 加上一個空白鍵,接著貼上你的專案資料夾路徑,告訴終端機你要在哪個資料夾執行動作。例如:

cd /Users/YourName/Desktop/Your-release

Step 2. 推送專案到 GitHub 倉庫

執行推送前,請確保你已經在 GitHub 網頁上建立好一個名為 polik-recovery (或你的專案名稱) 的「空倉庫」。接著,複製貼上以下指令來進行強制推送:

git push -u origin main -f

⚠️ 執行時的超重要注意事項:
• 如果終端機詢問您是否繼續連線,請勇敢地在鍵盤輸入 yes 然後按 Enter。
• 如果詢問金鑰密碼 (Enter passphrase),請輸入您當初設定 SSH Key 時的密碼。(新手必知:輸入密碼時,螢幕畫面上不會顯示任何星星符號或字元,這是正常的資安保護機制,請自信地盲打完畢並按下 Enter 即可!)

5. 步驟三:啟用 GitHub Pages,讓網頁上線!

當終端機跑完一堆進度條,最後顯示類似 Branch 'main' set up to track remote branch 'main' from 'origin' 的訊息時,就代表程式碼上傳大成功啦!最後一哩路,如果您上傳的是靜態網站,只要到 GitHub 網頁上開啟服務即可:

  1. 進入您剛剛成功上傳的 GitHub 倉庫 (Repository)。
  2. 點選上方選單最右側的 Settings (設定)
  3. 在左側側邊欄中找到並點擊 Pages
  4. 在 Source 或 Build and deployment 的區域中,將分支 (Branch) 選單調整為 main,然後點擊 Save 儲存。

稍等幾分鐘重新整理網頁,GitHub 就會自動為您生成一個專屬的網頁連結了!第一次設定 SSH 雖然有點繁瑣,但熬過了這次的「工程師成人禮」,以後每次上傳都只要簡單按下一鍵或一行指令就能解決,完全不用再反覆輸入帳號密碼。快去享受流暢開發的痛快感吧!

⚠️ 免責聲明:本文提供之指令與終端機操作步驟僅供教學與經驗分享參考。讀者在執行命令列指令(如 cd, git push -f 強制推送等)時,請務必先確認自己當下的資料夾路徑與電腦環境,避免誤傳或不小心覆蓋到非預期之專案檔案。各作業系統與本地環境設定可能略有差異,實際操作情況請以個人設備為主。

留言

這個網誌中的熱門文章

讓 AI 成為你的教學「分身」,準時下班不是夢—— GEM 教學應用實戰 (Google Educator Masterclass)

各位老師,辛苦了!在現今的教育現場,繁重的行政報表、課綱教案與親師溝通,總是把時間切割得零碎,「準時下班」似乎成了都市傳說。這份「GEM 教學應用實戰講義」,並非要讓 AI 取代您的教學專業,而是帶您打造一個不知疲倦、隨傳隨到的「數位分身」。     寫在前面:為什麼我們需要 AI 教學分身? 教師的角色早已不只是「傳道、授業、解惑」。透過掌握關鍵 AI 應用,我們要把省下來的時間,還給您自己,或是還給那些真正需要您陪伴的學生。 💡 核心心法: 「AI 負責打底與高效產出,老師負責審核與靈魂注入。」 第一章:課前準備與專屬「百寶箱」建置 在開始詠唱提示詞之前,建立一個順暢的數位工作環境是成功的一半。 1-1 雙螢幕/分割畫面操作(線上研習必備) 在線上實作研習中,最常發生的悲劇就是「切去操作 AI 視窗,就找不到講師的畫面了」。 Windows 系統秘技: 點選瀏覽器視窗上方標題列,按下鍵盤 Windows鍵 + 左/右方向鍵 ,視窗會瞬間對半貼齊螢幕。 Mac 系統秘技: 將游標懸停在視窗左上角的「綠色全螢幕按鈕」上,選擇「將視窗平鋪於螢幕左/右側」。 最佳配置: 左半邊放置 Google Meet 畫面(看講師示範),右半邊開啟您的 AI 助手與百寶箱網頁。 1-2 專屬百寶箱:線上指令庫快速連結 本次研習主辦方已經為大家建置了最強大的線上指令庫。我們不需要到處找檔案,請直接點選以下連結開啟這兩個專屬網站,它們就是你未來的「虛擬大腦」: 📖 GEM 教學「分身」 教師減負全方位應用指南 ⚙️ GEM 行政「引擎」 國中小處室效能提升指南 第二章:基礎賦能 —— 讓 AI 秒懂你的「5 元素萬用公式」與風險控管 很多人覺得 AI 給的答案「很廢、像官樣文章」,原因在於我們的指令太模糊。如果你遇到百寶箱中沒有的情境,請記住這個萬用公式。 2-1 破解黑盒子:5 元素提示詞公式 要讓 AI 產出精準的內容,請牢記: 「對象 + 任務 + 限制 + 格式 + 目的」 【對象】: 年級、程度、班級特性(例:針對注意力不集中的國一學生)。 【任務】: 教材、評語、活動、回覆(例:設計一份閱讀測驗)。 【限制】: 字數、時間、堂數、語氣(例:限 300 字,語氣要幽默)。 【格式】: 表格、條列、逐字稿、題庫(例:請用表格呈現,欄位包含....

2026高齡駕駛換照懶人包:70歲新制、75歲認知功能測驗、繳回駕照TPASS回饋一次看

家中長輩滿70歲、仍會騎車或開車出門嗎?預計2026年5月31日,高齡駕駛換照制度正式下修到70歲,但這不是要禁止長輩開車,而是透過體檢、交通安全教育與分級把關,讓長輩更安心、家人也更放心。本文已把容易誤會的期限、認知功能檢測與TPASS回饋方式完整整理,陪你用最清楚的方式看懂新制。     導讀區:這篇先幫你抓重點 這次高齡換照新制最容易被誤會的地方有三個:第一,不是所有人都要立刻衝去監理站,原則上要等監理所、站通知;第二,70歲到未滿75歲與75歲以上流程不同;第三,繳回駕照的3.6萬元不是一次領現金,而是符合資格後依實際搭乘大眾運輸支出給50%回饋。 70歲新制 體檢合格,加上免費安全教育與危險感知體驗,通過後駕照可使用到75歲。 75歲以上 維持每3年換照,需體檢、認知功能檢測或提出未患中度以上失智症證明。 放下方向盤 70歲以上自願繳回名下所有駕照,可申請TPASS乘車回饋,2年最高3.6萬元。 文章目錄 點擊快速跳轉 1. 2026高齡換照新制先看懂 2. 70歲與75歲流程差在哪 3. 換照流程照著做就好 4. 認知功能檢測考什麼 5. 出門前證件與費用清單 6. 逾期未換照的罰則 7. 繳回駕照與TPASS回饋 8. 家人陪辦提醒與常見問題 1. 2026高齡換照新制先看懂 預計2026年5月31日起,台灣高齡駕駛換照制度進入新的分級管理階段。過去大家比較熟悉的是75歲以上高齡駕駛換照,現在新制把關懷年齡提早到70歲,重點不是把長輩的車鑰匙收走,而是讓長輩在身體狀況還不錯的時候,透過體格檢查、安全教育課程與危險感知體驗,重新確認自己是否適合繼續騎車或開車。 這件事對很多家庭很實際。長輩可能每天騎機車買菜、接孫子、去醫院回診,也可能習慣自己開車到市場、活動中心或鄰近鄉鎮辦事。交通工具對長輩來說不只是移動方式,也是一種生活自主感。所以談高齡換照時,語氣不應該是「你老了不能開」,而是「我們一起確認怎麼出門比較安全」。 最重要的一句話 滿70歲以上長者原則上等監理所、站寄發換照通知再辦理,不需要因為聽到新制就急著提前換照。若有違規、吊扣、逾期或個案通知,則依監理機關通知內容辦理。 如果你是子女或晚輩,建議先不要用命令式口氣要求長輩放棄駕駛。比較好的做法,是陪他一起看通知書、安排體檢、理解流程,也一起討論如果未來少開車,附近有哪些公車、捷運、...

「2026台北鼠患危機:25年首見漢他病毒!見鼠地圖與滅鼠生態反撲全解析」

哈囉大家好!最近生活在台北的大家,出門走跳時有沒有覺得心裡毛毛的呢?2026年的台北街頭,不僅天氣變化多端,還迎來了一場讓人不容忽視的「鼠患風暴」。不僅是路上看到米奇的機率變高了,更可怕的是,伴隨而來的漢他病毒已經敲響了公衛警報!今天這篇文章,我將帶大家深入了解這次的鼠患危機、民間與市府的滅鼠大作戰,以及我們在撲滅老鼠的同時,必須正視的生態悲歌。準備好了嗎?讓我們一起看下去吧!     1. 25年首見!漢他病毒拉響台北公衛警報 時間拉回今年1月,台北市出現了讓所有醫療人員高度戒備的新聞—— 25年來首宗漢他病毒(Hantavirus)死亡案例 。一位居住在大安區的70多歲長輩因為感染不幸離世,緊接著今年又出現了第二宗確診案例。這不僅僅是冰冷的數字,更意味著藏匿在城市暗處的鼠患,已經直接威脅到市民的生命安全與健康。 漢他病毒主要透過老鼠的排泄物、尿液傳播,當帶有病毒的微粒飄散在空氣中被我們不小心吸入,或是接觸到受污染的物品,都有極高的感染風險。面對這樣無形的敵人,我們絕對不能掉以輕心,出入髒亂場所記得戴好口罩喔! 2. 抓鼠大作戰:民間見鼠地圖與市府對策 為了對抗這場危機,不僅官方動起來,民間力量也卯足了全力。熱心網友特別開發了數位化的 「見鼠地圖 Rat Radar (ratdar.taipei)」 ,透過民眾通報,讓大家可以隨時掌握各區的鼠患熱點與毒餌標記,出門時盡量避開高風險區域。 此外,蔣萬安市長也正式宣布,自5月11日起,全市行政區將同步展開清潔行動。市府更成軍了由環保局人員組成的 「鼠類偵防師」團隊 ,超過百名人力將深入社區協助民眾尋找老鼠源頭。為了壓制鼠群數量,據市議會資料指出,市府採購了約1公噸(1000公斤)的老鼠藥投入環境防治,這絕對是一場必須謹慎面對的硬仗! 2例 漢他確診案例 百人 鼠類偵防師 1公噸 採購老鼠藥 3. 滅鼠的隱形代價:猛禽與生態圈的悲歌 然而,當城市大量使用化學鼠藥來保護人類家園時,大自然卻默默承受了沉重的代價。根據 台灣猛禽研究會 的警告與過往數據顯示,在被尋獲的死亡猛禽中,竟然高達 61%的體內被檢測出鼠藥成分 !這數據真的讓人非常心痛。 這就是可怕的「次級毒殺」。老鼠吃下毒藥後不會立刻死亡,行動變得遲緩的牠們,反而成為了鳳頭蒼鷹、領角鴞等城市猛禽最容易捕捉的獵物。毒素就這樣順著食物鏈,一層一層在生態系...