程式 on DocusNotes

PowerShell與WSL

Sat, 05 Sep 2026 00:00:00 +0000

環境

作業系統：Windows 11
程式碼編輯器：Visual Studio Code
紀錄時間：2026年9月

Windows PowerShell和PowerShell 7+

Windows PowerShell是舊版的Windows內建工具（只支援Windows），而新一代的PowerShell是跨平台的現代化開源版本。

Windows PowerShell：只能在Windows作業系統上執行，版本停留在5.1，且是Windows系統的一部分無法移除。
PowerShell (v6/v7+)：是跨平台的，支援Windows、macOS和Linux。

PowerShell 7+

安裝

打開Windows PowerShell，輸入winget install Microsoft.PowerShell

更新

打開PowerShell，輸入winget upgrade Microsoft.PowerShell

其他

所有winget安裝軟體更新winget upgrade --all

最新的PowerShell可以用linux指令嗎？

這取決於你把PowerShell執行在哪個作業系統上。
當你在Linux或macOS上執行PowerShell，100% 可以直接使用真實的Linux指令，因為底層就是Linux系統。
當你在Windows上執行最新版PowerShell時，可以執行「部分常用」的Linux指令。

為了讓習慣Linux的人無痛上手，微軟在Windows的PowerShell內建了許多外號（別名）。當你輸入Linux指令時，它會在背後自動翻譯成對應的PowerShell指令，ls, cd, pwd, mkdir都能用。

雖然這些基礎指令能動，但不能加上Linux的進階參數。例如輸入ls -la會報錯，因為背後的Windows Get-ChildItem看不懂 -la是什麼。

如果你的Windows有安裝 WSL (Windows子系統Linux)，你只要在指令前面加上wsl，就能在最新版PowerShell裡調用100% 真正的Linux指令，
範例：wsl ls -la /home

WSL

安裝

打開PowerShell，輸入wsl --install
這個指令會自動幫你啟用Windows的虛擬化功能，並預設下載安裝最新的Ubuntu系統。
當視窗提示安裝完成後，手動重新啟動你的Windows 11電腦。這是啟用虛擬化核心必經的步驟。
重啟電腦並進入Windows後，系統會自動跳出一個黑色的Ubuntu命令列視窗（如果沒跳出，請去開始功能表搜尋「Ubuntu」並打開）。

設定帳號密碼：

Enter new UNIX username:
New password:
Retype new password:

當你看到綠色的文字（例如user@DESKTOP-XXXXXX:~$）時，就代表你已經成功登入真正的Linux系統了。現在，你可以在你原來的最新版PowerShell視窗裡，直接輸入wsl ls -la來調用Linux指令，或者輸入wsl直接切換進去Linux環境。

TOML語法

Sat, 05 Sep 2026 00:00:00 +0000

TOML的全名是Tom’s Obvious, Minimal Language（湯姆的明顯、極簡語言）。它的設計目標是成為一個比JSON更易讀、比YAML更嚴謹的組態設定格式。不同於YAML依賴縮排，TOML主要是透過方括號 [] 來定義資料結構。

核心規則

三個特點：

使用等號 = 賦值
TOML的鍵值對一律使用等號（例如 title = "我的文章" ）。
對空格非常寬容
等號兩邊有沒有空格都沒關係（ title=1 和 title = 1 都對），而且縮排只為了美觀，不影響程式解析。
嚴格的型態與字串要求：字串必須用引號包起來，布林值必須是小寫的 true 或 false 。

四大基礎語法與資料型態

在Markdown的文章開頭（Front Matter），你會用到的TOML語法主要有以下四種：

基礎鍵值對（Key-Value）

tomltitle = "我的第一篇文章" # 字串：TOML的字串「一定要」加引號
draft = false # 布林值：必須小寫
weight = 10 # 整數
price = 99.9 # 浮點數

字串與引號（String）
TOML區分雙引號與單引號的方式：

雙引號 "" （基本字串）：支援跳脫字元（例如 \n 代表換行）。
```
tomldescription = "第一行\n第二行"
```
單引號 '' （字面字串）：不解析任何跳脫字元，裡面寫什麼就完全顯示什麼（適合用來寫網址或正則表達式）。
```
tomlimage_url = 'https://example.com'
```

陣列 / 列表（Array）
用來設定多個同類型的資料（如文章標籤）。

單行寫法（最常用）：

tomltags = ["網站架設", "Hugo", "教學"]

多行寫法（適合項目很多時）：

YAML語法

Sat, 05 Sep 2026 00:00:00 +0000

YAML的設計核心是「人類可讀性高」，它的結構完全依賴縮排和特定的符號來決定。

核心規則

YAML三個禁忌：

只能使用「空格」縮排
絕對不能使用Tab鍵。如果使用Tab鍵，編譯時網站一定會報錯。通常建議固定使用2個空格作為一層縮排。
冒號後面一定要有空格
寫設定時，冒號後面必須加上一個空格（ 例如title: 我的文章 ），只寫 title:我的文章 是錯誤的。
大小寫敏感
Title 、 TITLE 和 title 在YAML裡被視為完全不同的東西。

四大基礎語法與資料型態

在Markdown的文章開頭（Front Matter），會用到的語法主要有以下四種：

基礎鍵值對（Key-Value）

最簡單的設定，用來宣告單一屬性。

yamltitle: 我的第一篇文章 # 字串：通常不需要加引號
draft: false # 布林值：必須是小寫的true或false
weight: 10 # 整數
price: 99.9 # 浮點數

字串與引號（String）

單引號會將內容視為純字串（Literal String）。裡面的所有字元都不會被轉義（Escape），寫什麼就是什麼。雙引號會解析跳脫字元（Escape Characters），用換行、縮排等特殊字元時用，如寫 text: "第一行\n第二行" 將會換行。定義物件（Key）時，YAML的Key通常不加引號，保持乾淨。布林值、數字、Null亦不加引號。

使用時機對照表

情況	無引號	`' '`	`" "`
一般純文字 ( `hello` )	建議使用	可用	可用
包含特殊符號 ( `:` , `#` , `[]` )	不可	最安全	可用
強制轉為字串 ( `true` , `123` )	不可，變布林/數字	最安全	可用
需要跳脫字元 ( `\n` 換行)	不可，失效	不可，失效	可用

範例：

中英文間隔CSS

Fri, 04 Sep 2026 00:00:00 +0000

環境

作業系統：Windows 11
程式碼編輯器：Visual Studio Code
紀錄時間：2026年9月

語法

text-autospace CSS屬性允許指定中日韓（CJK）字元和非中日韓字元之間的間距行為。

body {
 text-autospace: normal;
}

normal ：建立預設行為，自動在CJK字元與非CJK字元之間以及標點符號周圍新增間距。此值的效果等同於同時應用 ideograph-alpha 和 ideograph-numeric 。

為什麼用它代替空格

以往在網頁上用鍵盤打半形空格（Space）會顯得中英文間距過大（寬度高達0.5em）。而 text-autospace 是由瀏覽器自動計算並塞入約1/8 em的微小微調間距，視覺效果比純空格更緊湊、更具美感。

如果網頁內容本身已經有用鍵盤打的實體空格，瀏覽器在解析 text-autospace 時會自動跳過，不會讓你的間距疊加變得更寬。

在VS Code中把Markdown中英文之間的空格消除

方法一、搜尋與取代

在VS Code中打開你的檔案，按下Ctrl + H開啟取代視窗，並依照下列步驟設定：

開啟正規表達式模式：請務必點亮搜尋框最右側的 .* 圖示（或按下快捷鍵Alt + R，啟用正規表達式功能。
欄位輸入內容你需要分兩次操作，一次清除「中文+空格+英文」，一次清除「英文+空格+中文」：
- 步驟A：清除【中文 ➔ 英文】之間的空格尋找 (Find)： ([\u4e00-\u9fa5]+) +([a-zA-Z0-9]+) 取代為 (Replace)： $1$2 動作：點擊右側的Replace All（全部取代）圖示（或按Ctrl + Alt + Enter）。
- 步驟B：清除【英文 ➔ 中文】之間的空格尋找 (Find)： ([a-zA-Z0-9]+) +([\u4e00-\u9fa5]+) 取代為 (Replace)： $1$2 動作：再次點擊Replace All（全部取代）。

原理說明

[\u4e00-\u9fa5] ：代表所有的中文字（Unicode範圍）。 [a-zA-Z0-9] ：代表所有的英文字母與數字。 + （中間有空格）：代表匹配一個或多個連續的半形空格。 () 與 $1$2 ：把前後的文字暫存起來，並在取代時直接黏在一起，中間的空格就會被刪除。

Git bash設定

Thu, 03 Sep 2026 00:00:00 +0000

環境

作業系統：Windows 11
程式碼編輯器：Visual Studio Code
紀錄時間：2026年9月

在Windows Terminal中使用Git Bash

到Windows Terminal的設定畫面
左側選單到最下方，點擊「開啟JSON檔案」。

尋找 "profiles" 底下的 "list" 區段，將以下這段程式碼複製，貼到 "list": [ 的中括號內部（記得與其他項目之間用逗號 , 隔開）：

{
// 這是我手動新增的Git Bash設定檔
"guid": "{1c4de342-38b7-51cf-b111-23098613f530}",
"hidden": false,
"name": "Git Bash",
// 鎖定標籤頁標題，不要顯示冗長的路徑
"suppressApplicationTitle": true,
// 徹底關閉Windows Terminal的鈴鐺通知圖示與聲音
"bellStyle": "none",
// --login用來讀取個人設定，-i用來開啟互動打字模式
"commandline": "C:\\Program Files\\Git\\bin\\bash.exe --login -i",
"icon": "C:\\Program Files\\Git\\mingw64\\share\\git\\git-for-windows.ico"
}

注意：在JSON檔案中，標準語法其實不支援任何註解（像是 // 或 /* */ ）。如果直接寫 // ，很多軟體會直接報錯，導致設定檔失效。Windows Terminal和VS Code這兩款微軟的軟體在讀取settings.json時，有特別開外掛支援「JavaScript風格的註解」，可以直接使用 // 來寫單行註解。

說明

標籤頁標題

Git Bash預設會主動將目前的「工作目錄路徑」傳送給終端機，覆蓋掉你設定的名字。只需要把它關閉即可只顯示乾淨的「Git Bash」。

`--login` (登入模式)

告訴Bash：「請把我當成剛開機、第一次登入的使用者。」只有在 --login 模式下，Git Bash才會去讀取並執行讀取你的個人設定檔。如果拿掉它，終端機就不會載入你的自訂顏色與標籤設定。

程式 on DocusNotes

PowerShell與WSL

環境

Windows PowerShell和PowerShell 7+

PowerShell 7+

安裝

更新

其他

最新的PowerShell可以用linux指令嗎？

WSL

安裝

TOML語法

核心規則

四大基礎語法與資料型態

YAML語法

核心規則

四大基礎語法與資料型態

基礎鍵值對（Key-Value）

字串與引號（String）

中英文間隔CSS

環境

語法

為什麼用它代替空格

在VS Code中把Markdown中英文之間的空格消除

方法一、搜尋與取代

原理說明

Git bash設定

環境

在Windows Terminal中使用Git Bash

說明

標籤頁標題

--login (登入模式)

`--login` (登入模式)