Cursor does not yet have a complete Chinese interface officially. Even after installing the VSCode Chinese language pack, many users will still see English in Cursor-specific areas such as the Agent sidebar, settings page, and extension marketplace. This article introduces a complete Cursor Chinese localization tool that helps daily Cursor users replace common menus, buttons, prompts, and descriptions with Chinese as much as possible without modifying core programs, reducing reading and operation costs.
Operation tips:This tool is intended for daily Cursor users and has covered both Editor mode and Agent mode interfaces. Agent conversation content and model-generated content are not within the scope of interface localization.
Tool Introduction
Cursor has not yet provided a Chinese interface or official Chinese localization pack. The common practice is to install the VSCode Chinese localization extension, which can turn standard areas such as menus and general settings into Chinese, but Cursor-specific interfaces like the Agent sidebar, Cursor settings, and extension marketplace often remain in English.
The approach of the complete Cursor Chinese localization tool is: automatically install the VSCode Chinese language pack, and simultaneously inject a runtime script with a dictionary into the workbench to replace Cursor-specific interfaces with Chinese, making everyday clickable interfaces mostly readable at a glance.
Release address:https://www.vibepm.net/cursor/
Coverage Area
- Settings page:Options such as account, models, rules, tools & MCP, privacy, etc.
- Agent window:Conversation, command palette, mode switching (Plan / Ask / Debug / Multi-task), etc.
- Extension marketplace:Extension names, descriptions, get button, and marketplace-related text.
- Other interfaces:Welcome page, Git changes panel, some notifications and promotional pop-ups, etc.
Key Features
Automatically installs the VSCode Chinese language pack
The tool will automatically install the VSCode Chinese localization extension with one click, covering standard menus, general settings, and other areas. If there is an update to the language pack, it will download and install the matching language pack based on the version, saving the steps of manually searching and installing from the extension marketplace.
Dual-layer localization, more comprehensive coverage
By injecting scripts and local dictionaries, the tool can translate Cursor-specific interfaces, such as the agent sidebar, Cursor settings (account/model/rules/MCP), extension marketplace, welcome page, Git panel, and some notification pop-ups.
Without modifying the core program, one-click restore
The tool only modifies workbench-related files, for example workbench.html. If you need to restore the English interface, run the "Cancel Chinese Localization" script to restore; the installed VSCode Chinese language pack can be retained.
Low maintenance cost
After a minor update of Cursor, if some parts revert to English, usually running the startup script again once will suffice, and reinstalling the software is generally not required.
How to use
Environment Requirements
The localization tool requires Python 3.8+. On Windows, via Start_Chinese_Localization_Win.bat call, Mac / Linux via shell scripts.
Basic Steps
- Download and extract the localization tool; the archive contains
Start_Chinese_Localization_Win.bat、Start_Hanization_Mac.shscripts, etc. - Windows users double-click
Start_Chinese_Localization_Win.bat。 - Mac / Linux users execute in terminal
Start_Hanization_Mac.sh。 - The script will install the language pack and inject the localization, follow the prompts to optionally open Cursor.
- Completely exit and restart Cursor, do not just reload the window.
How to run in Mac Terminal
- Press
Cmd + Space, type "Terminal" and press Enter. - In the terminal, enter
bash(Note there is a space after bash). - Handle
Start_Hanization_Mac.shDrag into the terminal window, auto-complete the path and press Enter. - Follow the prompts to enter
YExecute localization.
What to do if the top menu is still in English?
If the top menu is still in English after installation, you can manually switch the display language:
- Press
Ctrl + Shift + P, on macOS useCmd + Shift + P。 - enter
Configure Display Language, select "Configure Display Language". - Select "Chinese (Simplified)" in the list or
zh-cn。 - Follow the prompts to completely exit and restart Cursor.
How to restore the English interface
Windows users double-click Cancel_Chinese_Localization_Win.bat; Mac / Linux users run Cancel_Chinese_Localization_Mac.sh. After restoration, you also need to fully exit and restart Cursor. The language pack will be kept, only the injection will be undone and the backup files will be restored.
Frequently asked questions
What to do if the Chinese localization fails after updating Cursor?
Just re-run the localization script once. After a minor Cursor update, the workspace files may be overwritten; re-injection usually restores it.
What to do if the Chinese localization has been applied but hasn't taken effect?
First, make sure you have fully exited and restarted Cursor. Do not just reload the window; it is recommended to completely exit from the system tray or processes before opening again.
What to do if running the script reports errors, opens Microsoft Store, or has no output?
This is usually because Python is not actually installed. Windows can run where python Check the path, if the path contains MicrosoftWindowsApps, it is recommended to install Python 3 from python.org and check the option Add python.exe to PATH, you can also execute:
winget install Python.Python.3.12After installation, reopen the terminal and use python --version to confirm the version.
What to do if it prompts "Installation is corrupted / installation appears to be corrupt"?
Chinese localization will modify workbench.html, Cursor will also verify product.json the checksums of multiple core files. You can run fix_verify_Win.bat, Mac / Linux use fix_verify_Mac.sh, you can also execute:
python Cursor_Localization_Tool.py --fix-checksumIf prompted that permissions are insufficient, on Windows right-click to run as administrator, after completion fully exit and restart Cursor.
What should I do if the top menu still doesn't have a Chinese option?
Search and install in the extension marketplace Chinese (Simplified) Language Pack, then re-execute the display language switch, and then completely restart Cursor.
Specify Cursor installation directory
If the tool does not automatically recognize the Cursor installation path, you can use Notepad to open the file in the directory Cursor_Localization_Tool.py, at the beginning of the file cd /d "%~dp0" add the installation directory configuration after it, and then re-run the startup script.
set CURSOR_INSTALL_DIR=D:Program FilescursorHere you fill in the path containing Cursor.exe the installation folder.
How to handle when errors still occur
If an error still occurs when executing the script, you can drag the Chinese localization script into the Cursor dialog box and tell it your installation directory, for example:
I need to install this localization tool, but an error occurred during localization. Please check and re-run the script. My installation directory is: XXX
Overall, this tool is more suitable for users who want to reduce the cost of reading English interfaces and frequently use Cursor Agent and Cursor settings pages. It does not change the model's capabilities, nor does it translate the content generated by the model. Its core value is to make the software interface closer to Chinese usage habits.
Join the discussion
You must log in to post a comment.
After logging in, you can join the discussion. New users can register an account for free.
Do not post spam comments, advertisements, or content with malicious links. Comments must comply with relevant laws, regulations, and community guidelines.