Duotify.ReplaceText 1.1.3

ReplaceText

一個強大的文字編碼轉換與字串替換工具，專為處理多種編碼格式的文字檔案而設計。預設會將所有程式碼轉換為 UTF-8 with BOM 編碼，也支援將常見的文字檔案轉換為 UTF-8 with BOM 編碼。

現在可作為 .NET Global Tool 安裝，讓您在任何地方使用 replacetext 命令！

🚀 快速開始

# 1. 安裝工具
dotnet tool install --global Duotify.ReplaceText

# 2. 轉換專案中的所有檔案為 UTF-8
replacetext /path/to/your/project

# 3. 完成！

📖 更多使用方式請參閱 安裝指南

功能特點

• 🔄 自動偵測並轉換多種編碼格式 (透過 UTF.Unknown 自動偵測未知編碼)
• 🔍 遞迴掃描目錄中的所有支援檔案
• ✏️ 批次字串替換功能
• 🎯 支援多種開發相關檔案格式 (.cs, .js, .html, .config 等)
• 🚫 自動套用 .gitignore 規則,避免意外轉換不應處理的檔案
• 🧪 測試模式 (Dry Run) 可在不修改檔案的情況下預覽變更
• 📊 詳細的輸出選項以追蹤處理進度

系統需求

• .NET 8.0 或更高版本

安裝

方式 1：安裝為 .NET Global Tool (推薦)

需要 .NET 8.0 SDK 或更高版本。

dotnet tool install --global Duotify.ReplaceText

安裝後可在任何位置使用 replacetext 命令：

replacetext /path/to/your/project

更新工具：

dotnet tool update --global Duotify.ReplaceText

解除安裝：

dotnet tool uninstall --global Duotify.ReplaceText

📖 詳細安裝說明請參閱 INSTALL.md

方式 2:從原始碼建構 (在本機安裝)

下列步驟示範如何從原始程式碼在本機安裝和測試 ReplaceText，包含：打包成本機 NuGet 套件後以全域工具安裝、安裝為 local tool，以及直接執行或發佈可執行檔三種常用方式。

注意：以下命令適用於已安裝 .NET 8.0 SDK 的 Windows PowerShell (pwsh)。

1. 建構並打包成本機 NuGet 套件，然後以全域工具安裝 (推薦)

   # 下載原始程式碼並切到專案資料夾
   git clone https://github.com/doggy8088/Duotify.ReplaceText.git
   cd ReplaceText
   
   # 建構並產生 nupkg (Release); 套件預設會輸出到 ReplaceText\nupkg
   dotnet pack .\ReplaceText\ReplaceText.csproj -c Release
   
   # 解除安裝舊版 (如果已安裝)
   dotnet tool uninstall --global Duotify.ReplaceText
   
   # 從本機 nupkg 資料夾安裝為全域工具
   dotnet tool install --global Duotify.ReplaceText --add-source .\ReplaceText\nupkg
   
   # 驗證安裝
   dotnet tool list -g
   replacetext --help
   

2. 安裝為 local tool (只在此儲存庫 / 專案範圍可用)

   # 在儲存庫根建立 tool manifest(如果尚未建立)
   dotnet new tool-manifest
   
   # 從本機 nupkg 安裝到 local tool(會記錄在 .config/dotnet-tools.json)
   dotnet tool install Duotify.ReplaceText --local --add-source .\ReplaceText\nupkg
   
   # 執行 local tool(透過 dotnet tool run)
   dotnet tool run replacetext -- --help
   

3. 直接從原始程式碼執行或發佈單一執行檔 (不需安裝)

   # 直接以 dotnet run 在開發/測試時執行
   dotnet run --project .\ReplaceText\ReplaceText.csproj -- C:\MyProject
   
   # 發佈為單一執行檔(例如 Windows x64)
   dotnet publish .\ReplaceText\ReplaceText.csproj -c Release -r win-x64 -p:PublishSingleFile=true -o .\ReplaceText\publish
   
   # 執行發佈後的可執行檔
   .\ReplaceText\publish\ReplaceText.exe C:\MyProject
   

   解除安裝：

   # 全域解除安裝
   dotnet tool uninstall --global Duotify.ReplaceText
   
   # local tool 解除安裝(在專案資料夾執行)
   dotnet tool uninstall Duotify.ReplaceText --local
   

方式 3：使用發行版本

從 Releases 頁面下載適合您作業系統的版本。

使用方法

作為 Global Tool 使用 (推薦)

# 轉換目錄中所有檔案為 UTF-8
replacetext /path/to/your/project

# 測試模式(不實際修改檔案)
replacetext /T /path/to/your/project

# 替換字串並轉換編碼
replacetext /path/to/your/project "oldText" "newText"

# 詳細輸出模式
replacetext /V /F /path/to/your/project

# GBK 優先模式(處理簡體中文)
replacetext /GBK /path/to/your/project

# 僅處理指定文字檔案（在 TextExtensions 清單內，例如 .txt、.md 等）
replacetext /MO /path/to/your/project
# 使用簡短別名
replacetext -mo /path/to/your/project

作為獨立執行檔使用

ReplaceText.exe [選項] <目錄|檔案> [舊字串] [新字串]

選項

• /T - 測試執行模式，不會寫入檔案 (Dry Run)
• /MO - 僅修改指定的文字檔案（僅處理 TextExtensions 清單中的副檔名）。此選項會隱含 /M。
• /mo - /MO 的簡短別名。
• /M - 修改已知的文字檔案 (預設會跳過 .txt 和 .csv 檔案)
• /V - 顯示詳細輸出模式，會顯示所有掃描的檔案清單
• /F - 顯示完整的檔案路徑 (預設僅顯示相對路徑)
• /GBK - 讓 GBK (GB18030) 字集優先於 Big5 判斷
• /U - 自動判斷未知檔案類型，嘗試以文字方式處理沒有副檔名或非典型副檔名的檔案 (若非文字檔則會跳過)

使用範例

1. 將目錄中所有檔案轉換為 UTF-8

ReplaceText.exe C:\MyProject

2. 測試模式檢查將要變更的檔案

ReplaceText.exe /T C:\MyProject

3. 替換字串並轉換編碼

ReplaceText.exe C:\MyProject "oldText" "newText"

4. 詳細輸出模式

ReplaceText.exe /V /F C:\MyProject

5. GBK 優先模式

ReplaceText.exe /GBK C:\MyProject

6. 自動判斷未知檔案類型 (/U)

當目錄中存在沒有副檔名或副檔名不常見的檔案時，使用 /U 可以讓工具嘗試以文字方式判斷並處理這些檔案 (若判定為二進位檔案則會跳過)：

ReplaceText.exe /U C:\MyProject

支援的檔案格式

預設支援以下檔案格式：

• .NET/Visual Studio: .cs, .vb, .vbs, .cshtml, .vbhtml, .razor, .aspx, .ascx, .ashx, .master, .asmx, .resx, .settings, .edmx, .dbml, .rdlc, .sln, .csproj, .vbproj, .wdproj
• Web (JavaScript/TypeScript): .js, .jsx, .ts, .tsx, .mjs, .cjs, .html, .htm, .css, .scss, .sass, .less, .vue, .svelte
• 配置與資料: .config, .xml, .xsd, .xsl, .xslt, .sitemap, .skin, .browser, .disco, .wsdl, .discomap, .webinfo, .cd, .wsf
• Classic ASP: .asp, .asa, .asax
• ActionScript: .as, .jsl
• Python: .py, .pyw
• Java: .java
• C/C++: .cpp, .c, .h, .hpp, .cc, .cxx, .hxx
• Go: .go
• Rust: .rs
• PHP: .php, .phtml
• Ruby: .rb, .erb
• Swift: .swift
• Kotlin: .kt, .kts
• Scala: .scala
• Shell: .sh, .bash, .zsh
• PowerShell: .ps1, .psm1
• Dart: .dart
• Objective-C: .m, .mm
• R: .r, .R
• SQL: .sql
• Perl: .pl, .pm
• Lua: .lua
• Groovy/Gradle: .groovy, .gradle

使用 /M 選項可額外處理：

• .txt, .md, .log, .csv, .ini, .json, .yml, .yaml, .properties, .toml, .env, .lock, .conf, .cfg, .gitignore, .editorconfig

注意：使用 /MO（或 -mo）會隱含 /M，但 /MO 僅會針對 TextExtensions 清單中的副檔名進行處理（會跳過預設的程式碼/專案檔案副檔名）。

開發

建構專案

dotnet build

執行測試

dotnet test

程式碼格式化

dotnet format

檢查程式碼格式

dotnet format --verify-no-changes

CI/CD

本專案使用 GitHub Actions 進行持續整合和部署：

• ✅ 自動建構 (Windows、Linux、macOS)
• ✅ 程式碼格式檢查
• ✅ 自動發布多平台二進位檔案

授權

MIT License

Copyright (c) 2010-2025 Will 保哥 (doggy8088)

完整授權條款請參閱 LICENSE

升級記錄

v1.0.0 (2025-10-08)

• 🎉 首次以 Duotify.ReplaceText 套件名稱發佈
• ✨ 新增 .gitignore 自動支援功能
  • 自動尋找並套用 .gitignore 規則
  • 避免意外轉換建構產物、套件檔案等
  • 大幅減少不必要的檔案處理 (測試中減少 97% 處理量)
• ✨ 升級至 .NET 8.0
• 🔧 現代化專案結構 (SDK 風格的 .csproj)
• 🤖 新增 GitHub Actions CI/CD
• 📝 新增 .editorconfig 以確保程式碼品質
• 🎯 支援多平台發布 (Windows、Linux、macOS)
• 🐛 修正所有編譯警告
• 📦 支援單一檔案發布

v2.0.0 (2025) - 舊套件名稱

• ✨ 升級至 .NET 8.0
• 🔧 現代化專案結構 (SDK 風格的 .csproj)
• 🤖 新增 GitHub Actions CI/CD
• 📝 新增 .editorconfig 以確保程式碼品質
• 🎯 支援多平台發布 (Windows、Linux、macOS)
• 🐛 修正所有編譯警告
• 📦 支援單一檔案發布

貢獻

歡迎提交 Issue 和 Pull Request！

相關連結

• 專案首頁
• 問題回報
• 發行版本