麒麟OS需依次完成Node.js/npm安装、TypeScript全局安装、VS Code离线扩展配置、tsconfig.json初始化及Fcitx5兼容性调优，方可启用TypeScript开发能力。
如果您已在麒麟OS上完成Node.js与Python基础环境配置，但尚未部署TypeScript开发能力，则可能是由于TypeScript编译器未安装或VS Code未正确集成TS语言服务。以下是针对麒麟OS（基于Debian/Ubuntu内核）的TypeScript安装与开发环境配置步骤：
一、确认并安装Node.js与npm
麒麟OS默认未预装Node.js，而TypeScript依赖npm进行安装与管理；需确保Node.js版本不低于18.x（LTS），且npm可正常调用。
1、打开终端，执行命令检查是否已安装Node.js与npm：node --version && npm --version
2、若提示command not found，使用APT安装LTS版本：sudo apt update && sudo apt install -y nodejs npm
3、验证安装后版本是否满足要求（Node.js ≥ 18.17，npm ≥ 9.6）；如版本过低，启用NodeSource源升级：curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt install -y nodejs
二、全局安装TypeScript编译器
全局安装tsc命令可使系统任意路径下直接调用编译器，适用于快速验证与通用项目构建。
1、在终端中运行安装命令：sudo npm install -g typescript
2、安装完成后验证版本：tsc --version（应输出Version 5.2或更高）
3、若提示权限错误（如EPERM或EACCES），避免使用sudo，改用NVM管理Node.js版本并重装：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash，然后重启终端并执行nvm install --lts && nvm use --lts && npm install -g typescript
三、在VS Code中配置TypeScript支持
麒麟OS自带Fcitx5输入法与国产显卡驱动可能影响VS Code插件加载，需离线安装核心扩展并手动指定解释器路径，以绕过网络策略与渲染兼容性限制。
1、访问Visual Studio Code官网下载对应架构的.deb安装包（如code_1.83.0-1726054803_amd64.deb），使用dpkg安装：sudo dpkg -i code.deb && sudo apt-get install -f -y
2、从Microsoft官方GitHub releases页面下载最新版TypeScript Language Basics扩展的.vsix文件（如ms-vscode.vscode-typescript-next-xx.x.x.vsix）
3、在VS Code中按Ctrl+Shift+P，输入Extensions: Install from VSIX并回车，选择已下载的.vsix文件完成安装
4、重启VS Code后新建文件夹，在其中创建index.ts，保存后观察右下角状态栏是否显示“TypeScript”语言模式；若未识别，点击该区域手动选择“TypeScript”
四、初始化TypeScript项目配置
tsconfig.json定义编译行为与类型检查规则，缺失该文件将导致tsc默认采用宽松策略，可能掩盖潜在类型错误。
1、在项目根目录打开终端，执行初始化命令：npx tsc --init
2、编辑生成的tsconfig.json，确保关键选项明确设置："target": "ES2022", "module": "CommonJS", "strict": true, "outDir": "./dist", "rootDir": "./src"
3、若项目含DOM操作（如浏览器API调用），需补充lib项："lib": ["ES2022", "DOM", "DOM.Iterable"]
4、保存后，在终端运行tsc，检查是否生成dist/index.js及是否报错
五、解决中文输入与语法高亮异常问题
麒麟OS默认Fcitx5与VS Code早期渲染后端存在候选框偏移、光标失焦、TS关键字不着色等问题，需调整启动参数与字体渲染策略。
1、为VS Code添加环境变量启动：在终端执行env GTK_IM_MODULE=fcitx5 QT_IM_MODULE=fcitx5 XMODIFIERS=@im=fcitx5 code --no-sandbox --disable-gpu
2、在VS Code设置中搜索“editor.fontFamily”，将值设为'JetBrains Mono', 'Fira Code', 'Noto Sans CJK SC', 'sans-serif'，确保中英文字符等宽对齐
3、禁用可能冲突的第三方主题或图标包，仅保留官方TypeScript扩展与Material Icon Theme（如已安装）
4、若仍出现TS语法未高亮，检查文件关联：右键编辑器标签页→“Change Language Mode”→选择“TypeScript”，并勾选“Configure 'TypeScript' language based on file extension”
