萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Linux SVN 「Can't convert string from UTF-8」編碼錯誤徹底解決

錯誤現象

svn: Can't convert string from 'UTF-8' to native encoding
svn: src/main/webapp/resources/js/My97DatePicker/中文文件名亂碼

核心原因:SVN 客戶端要求本地 Locale 支持 UTF-8,但系統環境變量 LC_CTYPE 或 LANG 設置為 C 或非 UTF-8 編碼。

一、診斷當前 Locale

locale
# 典型錯誤輸出:
LANG=en_US.UTF-8
LC_CTYPE="C"
LC_ALL=C

LC_ALL=C 會強制覆蓋所有類別為 C 語言環境(ASCII),導致 UTF-8 文件名無法轉換。

二、方案一:修改用戶級環境變量(推薦)

vim ~/.bash_profile
# 添加以下三行
export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8

source ~/.bash_profile
# 或 source ~/.bashrc

重新執行 svn co/up/cleanup 即可解決。

三、方案二:臨時指定 LC_CTYPE(快速驗證)

export LC_CTYPE="zh_CN.UTF-8"
# 或
export LC_CTYPE="zh_CN.GB2312"  # 視系統支持而定
export LANG="zh_CN.UTF-8"       # 另一常用變量名

此法不持久化,重新登入失效,適合臨時操作。

四、方案三:系統級修改(多用戶環境)

vim /etc/locale.conf
# 設置
LANG=en_US.UTF-8
LC_ALL=en_US.UTF-8

# 重新生成 locale(如缺失)
localedef -c -f UTF-8 -i en_US en_US.UTF-8

五、驗證與避坑

  • 執行 locale 確認 LC_CTYPE、LANG 均為 *.UTF-8
  • 重新 svn checkout 而非 update,避免工作副本已損壞
  • 若服務端文件名已亂碼,需服務端重命名後客戶端重新獲取
  • Docker 容器中需在 Dockerfile 設置 ENV LANG=en_US.UTF-8

總結

SVN 中文文件名問題本質是客戶端 Locale 缺失 UTF-8 支持。永久解決請修改 ~/.bash_profile 導出三大變量;系統級修改 /etc/locale.conf。切記:LC_ALL=C 是萬惡之源,生產環境嚴禁設置。

copyright © 萬盛學電腦網 all rights reserved