GitHub Copilot CLI 開發環境設置
在新機器上快速復原 Copilot CLI 工作環境的完整指南。
前置需求
確認以下工具已安裝:
| 工具 | 用途 | 安裝參考 |
|---|---|---|
| pnpm | Node.js 套件管理 | 請參考官方安裝頁面 |
| PHP | PHP 執行環境 | 依作業系統安裝 |
| Node.js | JS/TS 執行環境 | 建議透過 nvm 安裝 |
| Python | Python 執行環境 | 建議透過 uv 管理 |
1. LSP Server 安裝
PHP — intelephense
pnpm add -g intelephense
Node.js / TypeScript — typescript-language-server
pnpm add -g typescript-language-server typescript
Python — pyright
pnpm add -g pyright
2. LSP 設定檔
建立檔案 ~/.copilot/lsp-config.json(Windows:%USERPROFILE%\.copilot\lsp-config.json):
{
"lspServers": {
"intelephense": {
"command": "intelephense",
"args": ["--stdio"],
"fileExtensions": {
".php": "php"
}
},
"typescript": {
"command": "typescript-language-server",
"args": ["--stdio"],
"fileExtensions": {
".js": "javascript",
".jsx": "javascriptreact",
".ts": "typescript",
".tsx": "typescriptreact",
".mjs": "javascript",
".cjs": "javascript"
}
},
"pyright": {
"command": "pyright-langserver",
"args": ["--stdio"],
"fileExtensions": {
".py": "python"
}
}
}
}
3. MCP 設定
建立或更新 ~/.copilot/mcp.json(Windows:%USERPROFILE%\.copilot\mcp.json):
{
"mcpServers": {
"context7": {
"tools": [
"get-library-docs",
"resolve-library-id"
],
"type": "http",
"url": "https://mcp.context7.com/mcp"
}
}
}
context7 使用遠端 HTTP 模式,不需要本地安裝任何套件。
4. 驗證
啟動 Copilot CLI 後,執行以下指令確認設定生效:
/lsp → 查看 LSP server 載入狀態
/mcp → 查看 MCP server 連線狀態
快速腳本(一鍵安裝)
# 1. 安裝 LSP servers
pnpm add -g intelephense typescript-language-server typescript pyright
# 2. 建立設定目錄
mkdir -p ~/.copilot
# 3. 寫入 LSP 設定
cat > ~/.copilot/lsp-config.json << 'EOF'
{
"lspServers": {
"intelephense": {
"command": "intelephense",
"args": ["--stdio"],
"fileExtensions": {
".php": "php"
}
},
"typescript": {
"command": "typescript-language-server",
"args": ["--stdio"],
"fileExtensions": {
".js": "javascript",
".jsx": "javascriptreact",
".ts": "typescript",
".tsx": "typescriptreact",
".mjs": "javascript",
".cjs": "javascript"
}
},
"pyright": {
"command": "pyright-langserver",
"args": ["--stdio"],
"fileExtensions": {
".py": "python"
}
}
}
}
EOF
# 4. 寫入 MCP 設定
cat > ~/.copilot/mcp.json << 'EOF'
{
"mcpServers": {
"context7": {
"tools": [
"get-library-docs",
"resolve-library-id"
],
"type": "http",
"url": "https://mcp.context7.com/mcp"
}
}
}
EOF
Windows 使用者:請將
~/.copilot/替換為%USERPROFILE%\.copilot\,並使用 PowerShell 執行對應命令。
Copilot CLI 自動設置 Prompt
在新環境啟動 Copilot CLI 後,貼上以下 prompt,讓 Copilot 自行查找最新做法並完成設置:
請幫我完成 Copilot CLI 的開發環境設置:
1. 我使用 pnpm 管理所有 LSP 套件。
請全域安裝下列語言的 LSP server(自行查找目前主流推薦的套件名稱與安裝方式):
- PHP
- JavaScript / TypeScript
- Python
2. 根據安裝結果,產生並寫入 ~/.copilot/lsp-config.json,
設定每個 LSP server 的啟動指令與對應的副檔名。
3. 在 ~/.copilot/mcp.json 加入 context7 MCP server,
使用官方建議的最新連線方式(HTTP remote 或本地安裝皆可,以官方文件為準)。
4. 完成後用 /lsp 和 /mcp 確認設定已正確載入,並回報結果。