1.下載 Protocol Buffers 編譯器(protoc) 前往 Protocol Buffers GitHub Releases 頁面。在 "Assets" 下找到適合您系統的壓縮文件,通常為 protoc-{version}-win32.zip 或 protoc-{version}-wi ...
1.下載 Protocol Buffers 編譯器(protoc)
前往 Protocol Buffers GitHub Releases 頁面。在 "Assets" 下找到適合您系統的壓縮文件,通常為 protoc-{version}-win32.zip 或 protoc-{version}-win64.zip,其中 {version} 是版本號。
2.解壓縮 Protoc 編譯器
創建一個空文件夾,用於存放 protoc 編譯器,將下載的壓縮文件解壓到該文件夾。找到 bin 文件所在目錄,將路徑複製下來。
3.設置環境變數
滑鼠點擊桌面左下角的搜索框,然後輸入“環境變數”,搜索出來後雙擊滑鼠點進去。
在彈出的視窗中選擇“高級->環境變數”按鈕。在“用戶變數”里找到 path,雙擊打開。
點擊“新建”並添加 protoc 編譯器的路徑,將剛纔下載地址的 bin 路徑粘貼進去即可。
4.驗證安裝
我們現在打開控制台看一下變數是否配置成功,Win+R然後輸入 cmd,在命令行中運行命令protoc --version,如果看到版本信息,說明配置成功。
5.使用 protoc 編譯 .proto 文件 轉成C#,.cs文件
-
檢查 .NET SDK 安裝
dotnet --version
-
重新安裝 gRPC C# 工具,先執行卸載,再裝
dotnet tool uninstall -g dotnet-grpc dotnet tool install -g dotnet-grpc
- 手動下載和安裝【如果以上步驟無法安裝】
如果通過 dotnet tool install 命令無法安裝 grpc_csharp_plugin.exe,你可以嘗試手動下載和安裝。
訪問 gRPC GitHub 倉庫。
導航到 grpc/src/csharp/Grpc.Tools 目錄。
下載適用於你操作系統的 Grpc.Tools 包。
-
手動安裝
解壓下載的 Grpc.Tools 包。
將解壓後的文件夾中的 tools 目錄複製到你希望安裝插件的位置。
將插件路徑添加到系統的 PATH 環境變數中。 -
檢查環境變數
確保 grpc_csharp_plugin.exe 的路徑已添加到系統的 PATH 環境變數中。你可以通過以下步驟檢查和配置環境變數:
Windows
右鍵點擊“此電腦”或“電腦”,選擇“屬性”。
點擊“高級系統設置”。
在“系統屬性”視窗中,點擊“環境變數”按鈕。
在“系統變數”部分,找到並選擇 Path 變數,然後點擊“編輯”。
確保 C:\Users<YourUsername>.dotnet\tools 路徑已添加到 Path 變數中。如果沒有,請點擊“新建”並添加該路徑。
Linux/macOS
打開終端。
編輯 ~/.bashrc 或 ~/.zshrc 文件,添加以下行:
export PATH="$PATH:$HOME/.dotnet/tools"
保存文件並運行以下命令使更改生效:
source ~/.bashrc
或
source ~/.zshrc
- 使用絕對路徑
如果你找到了 grpc_csharp_plugin.exe 的路徑,可以使用絕對路徑來運行 protoc 命令:
example.proto文件內容
生成C#類文件的命令:
protoc --proto_path=D:\Project\GrpcServiceDemo\protocolbuffers\protos --csharp_out=D:\Project\GrpcServiceDemo\protocolbuffers\codes --grpc_out=D:\Project\GrpcServiceDemo\protocolbuffers\codes --plugin=protoc-gen-grpc=D:\Project\GrpcServiceDemo\protocolbuffers\tools\windows_x64\grpc_csharp_plugin.exe example.proto
執行成功後,會生成這兩個文件:
6.如果通過git倉庫代碼無法找到插件grpc_csharp_plugin.exe ,可以通過以下方式
-
手動下載
訪問 NuGet 官方網站。
搜索 Grpc.Tools 包。
下載適用於你操作系統的包(例如 Grpc.Tools.2.41.0.nupkg)。 -
解壓 Grpc.Tools 包
下載完成後,解壓 Grpc.Tools 包。你可以使用以下命令解壓 .nupkg 文件:mkdir Grpc.Tools unzip Grpc.Tools.2.41.0.nupkg -d Grpc.Tools
-
配置環境變數
將 grpc_csharp_plugin.exe 的路徑添加到系統的 PATH 環境變數中。
Windows
右鍵點擊“此電腦”或“電腦”,選擇“屬性”。
點擊“高級系統設置”。
在“系統屬性”視窗中,點擊“環境變數”按鈕。
在“系統變數”部分,找到並選擇 Path 變數,然後點擊“編輯”。
確保 Grpc.Tools/tools/windows_x64 路徑已添加到 Path 變數中。如果沒有,請點擊“新建”並添加該路徑。
Linux/macOS
打開終端。
編輯 ~/.bashrc 或 ~/.zshrc 文件,添加以下行:
export PATH="$PATH:/path/to/Grpc.Tools/tools/linux_x64"
或
export PATH="$PATH:/path/to/Grpc.Tools/tools/macosx_x64"
保存文件並運行以下命令使更改生效:
source ~/.bashrc
或
source ~/.zshrc