news 2026/2/14 8:22:55

OpenCode 从 Windows 迁移到 Wsl2

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
OpenCode 从 Windows 迁移到 Wsl2


之所以需要将Windows运行的好好的OpenCode迁移到Wsl主要是为了解决Skill在运行过程中,部分调用工具命令Git Bash命令行与Windows目录盘符以及执行程序环境之间的不兼容问题,索性直接切换到仿Linux环境,保证文件目录体系的运行一致性,降低OpenCode的使用难度。

前置准备

Wsl2

Windows中已经安装了Wsl并升级到了Wsl2,具体安装教程可以查看微软文档,本文不再进行介绍。

子系统镜像

这里使用的是Ubuntu22.04,是Ubuntu官方网站针对Wsl对应版本的镜像文件。这里是Ubuntu2404-250130_x64.wsl下载地址,可以自行下载。

既有经验

Windows中已经成功运行安装过OpenCode,并熟悉./config/opencode目录以及./local/share/opencode目录。

迁移步骤

下载分发版镜像

Ubuntu2404-250130_x64.wsl下载地址

安装分发版镜像

对应Ubuntu2204-250130_x64.wsl这个镜像文件来说,使用高版本wsl有两种加载方式。
方式一(推荐)
使用--import指令,导入过程中,需要设置wsl对应的分发版名称以及导入之后本地磁盘文件的物理输出路径,同时首次导入需要设置默认的用户账户以及密钥。

>wsl --import[wsl_name][out_dir]./Ubuntu2404-250130_x64.wsl

方式二
先安装挂载,退出并停止会话后,再移动到指定目录。
进行安装。

wsl --install --from-file ./Ubuntu2404-250130_x64.wsl --version2--name[name]

输出如下:

正在安装: Ubuntu2404-250130_x64.wsl 已成功安装分发。可以通过 “wsl.exe -d ubuntu2204-opencode” 启动它

输入账户和密钥。

正在启动 ubuntu2204-opencode... Provisioning the new WSL instance ubuntu2204-opencode This might take a while... Create a default Unix user account:[username]New password: Retype new password: passwd: password updated successfully To run acommandas administrator(user"root"), use"sudo <command>".See"man sudo_root"fordetails.

退出并关闭。

wsl -d[wls_name]--shutdown

此处wsl_nameubuntu2204-opencode

wsl -d ubuntu2204-opencode --shutdown

移动分发版系统到指定目录(因为默认安装,对应镜像磁盘文件在C盘),移动成功后就可以在目标路径文件夹看到一个<wsl_name>.vhdx文件。

wsl --manage[name]--move[绝对路径文件夹]

安装OpenCode

进入目标子系统,并输入安装时,设置的密钥。

wsl -d[wsl_name]

切换到用户根目录。

cd~

这里为了简化过程,采用在线脚本安装方式,默认安装到当前用户.opencode文件夹中,也可以通过设置环境变量OPENCODE_HOME=/usr/local/bin进行处理。

curl-fsSL https://opencode.ai/install|bash

之后就是静静等待下载和安装。
安装完成后,当前会话需要注意,直接查找whereis opencode可能不会看到对应命令,而是会看到宿主机中的opencode目录,类似如下:

$whereisopencode opencode: /mnt/d/nvm/v20.19.5/opencode

这个时候,不要认为是安装失败,exit当前会话,重新使用wsl -d [wsl_name]进入会话。

exit

重新进入会话。

wsl -d[wsl_name]

查看指令。

whereisopencode

输出如下,表示安装成功:

opencode: /home/llr/.opencode/bin/opencode /mnt/d/nvm/v20.19.5/opencode

安装oh-my-opencode

这里也是用在线安装,但是需要注意的是安装oh-my-opencode之前,需要系统中包含unzip指令,以及bun。如果没有unzip,将导致bun在线脚本无法正常执行。

apt-getinstallunzip-y

安装成功后,执行bun在线安装脚本。

curl-fsSL https://bun.sh/install|bash

安装成功后,当前会话如果需要立即生效,需要执行source加载执行当前会话,添加环境变量,此处userllr

source./home/[user]/.bashrc

查找bun是否添加环境变量。

whereisbun

输出如下,表示环境变量添加成功:

bun: /home/[user]/.bun/bin/bun

开始安装oh-my-opencode,其中--claude=yes --chatgpt=yes --gemini=yes如果都没有可以设置为no

bunx oh-my-opencodeinstall--no-tui --claude=yes --chatgpt=yes --gemini=yes

安装成功后,进行验证。

cat~/.config/opencode/opencode.json|grep"oh-my-opencode"

输出如下,表示安装成功:

"oh-my-opencode"

找到一个目录,打开运行命令,第一次需要下载依赖,会比较缓慢出现黑屏,需要耐心等待。

opencode

运行正常如下:

迁移Windows配置

基础配置安装好之后,就可以迁移Windows中的配置到wsl分发系统中。
拷贝WindowsC:/Users/ll/.local/share/opencode/auth.json/home/[user]/.local/share/opencode/目录下。
拷贝Windows./config/opencode/下的配置oh-my-opencode.jsonopencode.jsonwsl的用户目录/home/[user]/.config/opencode/

迁移之后,退出opencode,再重新进入,如果提示配置错误,就按照错误提示进行问题修复,一般都是缺少插件,按照之前的逻辑进行重新安装即可。

注意事项

唯一需要注意的是,此时使用的npmnode.js实际是使用的Windows主系统的,虽然大多数时候不会存在问题,架不住有那么个意外,建议重新安装nodejs以及npm
验证方式如下:

whereisnpm

输出结果如下,表示实际还是使用的主系统的:

npm: /mnt/d/nvm/v20.19.5/npm

迁移总结

以上为Windows迁移到Wsl中的整个过程,基本上没有太多的问题,主要还是考验读者对两个操作系统的应用下层环境变量部分的熟悉程度,在linux下能避免不少跨操作系统带来的文件目录层面的干扰问题。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/2/10 11:19:58

FSMN-VAD金融录音分析:合规审计片段提取部署教程

FSMN-VAD金融录音分析&#xff1a;合规审计片段提取部署教程 1. 引言&#xff1a;为什么你需要语音端点检测&#xff1f; 在金融行业的合规审计中&#xff0c;大量的电话录音、会议记录和客户服务对话需要被系统化处理。传统方式依赖人工逐段回放&#xff0c;耗时耗力且容易遗…

作者头像 李华
网站建设 2026/2/13 6:14:19

verl轻量级优势体验:资源占用出乎意料低

verl轻量级优势体验&#xff1a;资源占用出乎意料低 在大模型后训练领域&#xff0c;强化学习&#xff08;RL&#xff09;框架往往给人留下“重型”“高门槛”“吃显存”的刻板印象——动辄需要数十张A100、复杂的分布式配置、冗长的启动时间。但最近接触的 verl 框架&#xf…

作者头像 李华
网站建设 2026/2/7 2:31:48

金融、法律场景必备|PaddleOCR-VL-WEB实现表格公式精准提取

金融、法律场景必备&#xff5c;PaddleOCR-VL-WEB实现表格公式精准提取 在金融报表分析、法律合同审查和学术文献处理中&#xff0c;一个长期存在的难题是&#xff1a;如何从复杂的文档中准确提取结构化信息。尤其是当文档包含大量表格、数学公式、多语言混排或扫描图像质量不…

作者头像 李华
网站建设 2026/2/13 14:02:00

AI专著生成高效之道:工具深度解析,开启专著写作新体验

学术专著需要严谨的态度&#xff0c;这背后有大量的数据和资料在支撑。搜集这些资料和整合数据常常是写作过程中的繁琐环节&#xff0c;耗时费力。研究者必须全面查找国内外的相关文献&#xff0c;确保这些文献的权威性和一致性。他们还需要追溯到原始的出处&#xff0c;避免错…

作者头像 李华
网站建设 2026/2/14 6:30:51

掌握AI专著写作技巧,搭配这些工具,快速完成学术专著创作

学术专著的写作离不开大量的资料与数据支撑&#xff0c;资料的搜集和数据的整合却是写作过程中最为繁琐和耗时的步骤。研究者需要全面全面地收集国内外的先进文献&#xff0c;这不仅要求文献具备权威性与相关性&#xff0c;还需要追溯到原始来源&#xff0c;以避免二手引用的错…

作者头像 李华
网站建设 2026/2/12 2:28:43

Z-Image-Turbo环境推荐:集成ModelScope依赖的一键镜像使用指南

Z-Image-Turbo环境推荐&#xff1a;集成ModelScope依赖的一键镜像使用指南 1. 引言&#xff1a;为什么你需要一个开箱即用的文生图环境&#xff1f; 你有没有遇到过这种情况&#xff1a;兴致勃勃想试试最新的AI绘画模型&#xff0c;结果第一步下载权重就卡住——30GB、40GB甚…

作者头像 李华