Skip to content

Fix CJK character display issues in Windows terminals #10491

Closed as not planned
Closed as not planned

Description

@Observer-GGboy

Problem

OpenCode terminals on Windows do not properly display CJK (Chinese, Japanese, Korean) characters. Instead, they appear as gibberish, question marks, or cause encoding errors.

Affected Scenarios

  1. Terminal Output

    $ echo "你好世界"
    ?????
    
  2. Python Scripts

    $ python -c "print('你好')"
    UnicodeEncodeError: 'ascii' codec can't encode characters
    
  3. Git Operations

    $ git status
    ?? "\346\226\346\231\230.md"
    

Root Cause

Windows historically uses GBK/GB2312 encoding by default, not UTF-8. This causes issues when:

  • Terminal code page is not set to UTF-8 (CP65001)
  • Environment variables (LANG, LC_ALL) are not configured
  • Python's UTF-8 mode is not enabled
  • Shell encoding (PowerShell/CMD) is not configured

Proposed Solution

Add platform-specific UTF-8 defaults for Windows PTY (pseudo-terminal) creation:

  1. Environment Variables

    • Set LANG=en_US.UTF-8
    • Set LC_ALL=en_US.UTF-8
    • Set PYTHONUTF8=1 (Python 3.7+)
    • Set PYTHONIOENCODING=utf-8
  2. Shell Startup Arguments

    • CMD.exe: Run chcp 65001 to set code page to UTF-8
    • PowerShell: Configure OutputEncoding and InputEncoding to UTF-8

Impact

  • Target Platform: Windows only (no impact on macOS/Linux)
  • User-Visible: Yes (fixes CJK character display)
  • Backwards Compatible: Yes (only sets defaults, users can override via env parameter)

Related

Activity

  1. github-actions commented on Jan 25, 2026

    @github-actions
    Contributor

    This issue might be a duplicate of existing issues. Please check:

    Feel free to ignore if none of these address your specific case.

  2. FIXUAI commented on Mar 24, 2026

    @FIXUAI

    I can reproduce a similar issue on OpenCode Desktop 1.3.0 on Windows.

    This is not only TUI input/rendering for CJK. I also get garbled Chinese output when Desktop runs terminal commands through the built-in shell tool.

    Repro:

    1. Open OpenCode Desktop on Windows
    2. Run a command like where docker
    3. If Windows returns a localized Chinese message, the output is garbled

    Example output:
    ��Ϣ: ���ṩ��ģʽ�޷��ҵ��ļ���

    Expected:

    • Chinese output is displayed correctly

    Actual:

    • Chinese output is mojibake / incorrectly decoded

    Relevant evidence:

    • Log path: C:\Users\fixui\.local\share\opencode\log\2026-03-23T043957.log:108
    • Log line: service=bash-tool shell=cmd.exe bash tool using shell

    So this seems related to Windows shell/code-page handling for cmd.exe output in Desktop as well, not only TUI text rendering.

    Happy to test a fix if needed.

  3. github-actions commented on Jul 6, 2026

    @github-actions
    Contributor

    To stay organized issues are automatically closed after 60 days of no activity. If the issue is still relevant please open a new one.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions