vsix とは、VS Code の拡張機能をまとめた配布用のファイルで、VS Code に入れて使う物です。
- .vsix を VS Code に入れる道(画面・コマンドパレット・
code --install-extension) vsce packageから vsce のpublishまで、Visual Studio Marketplace に出す手順と Azure DevOps の PAT の作り方- Open VSX との違いと、当社が拡張を公開して踏んだ記録(公開済みと誤った回・同じ版は出し直せない・身元の権限)
当社は VS Code の拡張(mikoto.bluelamp)を、AIエージェントの席が公開の workflow を撃つ形で出しています。この頁は、その手順と、席が実際につまずいた所を並べた手引きです。
.vsix の中身と、VS Code に入れる道
VS Code の公式の手引きは、拡張を「包む(packaging)」とは拡張を収めた .vsix のファイルを作る事で、そのファイルは VS Code に入れられる、と書いています。Marketplace を通さずに、手元の .vsix を直接入れる道は次の 3 つです(出典: Extension Marketplace)。
- 拡張機能の画面の「…」の一覧から[Install from VSIX]を選ぶ
- コマンドパレットで「Extensions: Install from VSIX」を撃ち、.vsix を選ぶ
- 端末で
code --install-extension myextension.vsixを撃つ
.vsix から入れた拡張は、その拡張の自動更新が既定で切られます。Marketplace から入れ直すまでは、新しい版が出ても勝手には上がりません(出典: Extension Marketplace)。
vsce package から vsce の publish まで:Marketplace に出す手順
| 順 | やる事 | コマンド・画面 |
|---|---|---|
| 1 | vsce を入れる(Node.js が要る) | npm install -g @vscode/vsce |
| 2 | Azure DevOps で PAT を作る | Organization は All accessible organizations、Scopes は Custom defined で Marketplace の Manage |
| 3 | publisher を作る | Marketplace の管理の画面で[Create publisher]。ID は後から変えられない |
| 4 | PAT で publisher に入る | vsce login <publisher id> |
| 5 | .vsix を作る | vsce package(拡張の根のフォルダに .vsix ができる) |
| 6 | 公開する | vsce の publish(版を上げて出すなら vsce の publish minor や vsce の publish 1.1.0) |
出典: Publishing Extensions(VS Code の公式)。表の順 1〜6 は公式の手引きの流れを並べ直した物で、vsce の publish minor は 1.0.0 を 1.1.0 にし、どちらの書き方も package.json の版を書き換えてから出します。
試しの版(pre-release)は vsce package --pre-release や vsce の publish --pre-release で出します。semver の pre-release の印(-beta など)は使えず、正式版と試しの版は版の番号を分けます。公式は正式版を 0.2.*、試しの版を 0.3.* のように分ける例を挙げています(出典: Publishing Extensions)。
azure devops personal access token の作り方と、その先
PAT の Authorized Scopes が Marketplace(Manage)になっていないと公開は通りません。また公式の手引きは PAT を「推奨しない」と書き、Azure DevOps の全体向けの PAT(global PAT)は 2026 年 12 月 1 日に退役すると告げています(出典: Publishing Extensions)。これから組むなら、鍵を置かずに済む形を先に考えておく方が手戻りが少ないです。
当社は公開の身元を個人の鍵(PAT)から OIDC(GitHub Actions の身元)に替えました。替えた後、当社のもう 1 つの拡張の公開が needs View user permissions on /<publisher> で落ちました。身元を publisher の Members に足していたのは片方の publisher だけで、もう片方は 9 月 30 日から一度も公開していなかったため、誰も気づいていませんでした。Members にその身元を Contributor で足して撃ち直しています(出典: 社の実測 2026-10-26)。publisher が複数あるなら、身元を替えた日に全部の Members を見ておくのが要点です。
Visual Studio Marketplace と Open VSX の違い
| Visual Studio Marketplace | Open VSX | |
|---|---|---|
| 公開の道具 | vsce の publish | ovsx の publish -p <token>(作った .vsix を渡すなら ovsx の publish <file> -p <token>) |
| 前に要る物 | Azure DevOps の PAT と publisher | eclipse.org のアカウント、Eclipse Foundation との Publisher Agreement、Access Token |
| 名前の置き場 | publisher(ID は変えられない) | namespace(npx ovsx create-namespace <name> -p <token> で先に作る。name は package.json の publisher) |
| 鍵の扱い | Marketplace(Manage)の範囲を付ける | 表示は作った時の 1 回だけ。公開する場所ごとに作るのを勧めている |
出典: Publishing Extensions、Publishing Extensions(Open VSX の wiki)。Open VSX には、作った .vsix をそのまま渡して出せます。
当社は Open VSX(Cursor など VS Code 互換のエディタが使う置き場)への配布を再開するかを決めました。答えは、出荷先は Visual Studio Marketplace の 1 系統のまま。今は要望が無いので畳み、Cursor 系の利用者から要望が出たら次の版から同時に出す、です(出典: 社の実測 2026-09-18)。出し先を増やすと、下に書く「出たかどうかを確かめる」所も倍になるためです。
当社が拡張を公開して踏んだ記録
dry_run の既定のせいで「公開済み」と誤った
担当の席が公開の workflow を撃ちましたが、入力の dry_run の既定が「出荷しない」だったため、.vsix を作る所までしか走りませんでした。席は緑の結果を見て「公開済み」と中継し、別の席が Marketplace の版の一覧(最新が 1 つ前の版のまま)を見て誤りに気づきました。dry_run を明示的に外して撃ち直すと「Published mikoto.bluelamp v1.3.54」と出ましたが、Marketplace の一覧はキャッシュで遅れ、しばらく前の版のままでした(出典: 社の実測 2026-10-04)。
以後の決まりはこうです。公開は workflow の success ではなく、Marketplace に版が出たのを見てから「出た」と言う。npm でも、dry-run が緑なのに本番は落ちる事があり、送った物と出た物を分けて見る話を npm publish の頁に書いています。
同じ版の番号は出し直せない:戻すときは番号を上げる
Marketplace では、同じ版の番号を出し直せません。公式の手引きも、消した版の番号は新しい公開に使えず、最新の版は消せないと書いています(出典: Publishing Extensions)。そこで当社は、前の版の中身を、版の番号を上げて出し直す形で戻します。公開のたびに、この戻し方を先に書いてから撃ちます(出典: 社の実測 2026-10-16、2026-11-13・11-16・11-17・11-18・11-19 の公開でも同じ)。
| 場面 | 版の番号 | 中身 |
|---|---|---|
| 戻したい版 | 1.3.75 | 1.3.75 の中身 |
| 戻すために出す版 | 1.3.76 | 1.3.74 の中身 |
出典: 社の実測 2026-10-16(当社の戻し方の例。番号を下げて 1.3.74 を出し直す事はできない)。
出す前に試しの VS Code で動かし、出した後に中身を比べる
公開の前に、dry_run で作った .vsix を試しの VS Code に入れます。この VS Code は公式の zip を使い、HOME を分けて普段の環境から隔離した物です。そこで拡張が起動すること(エラー 0)・画面・ログインまでを確かめてから、正式版だけを出します。試しの版(pre-release)は出していません(出典: 社の実測 2026-11-13・11-16・11-17)。
公開の後は、Marketplace から落とした物(vspackage)を展開し、確かめた .vsix と中身の差が 0 であることを測ります。2026-10-16 の公開では dist の sha256 が一致しました(出典: 社の実測 2026-10-16・11-13・11-16・11-17)。手元で動いた物と、利用者に届く物が同じだと言えるのはこの比べ方だけです。
PAT の正本がどこにも無かった
公開に使う PAT(GitHub の repository secret・長さ 84)の正本が、どこにも残っていませんでした。GitHub の secret は読み戻せません。そこで金庫に残っていた PAT 5 本を新しい順に vsce verify-pat で測り、生きていた 1 本を承認つきの environment の secret へ標準入力で入れ、既定の枝からだけ読める形にして repository secret を消しました。人に新しい PAT の発行を頼む必要は無くなりました(出典: 社の実測 2026-10-10〜10-11)。environment の承認で公開が止まる仕組みは GitHub Actions の environment の頁に書いています。
1 回目が依存の取得で落ち、撃ち直すと通った
公開の workflow が、1 回目は pip が azure-cli の依存を PyPI から引けずに落ちました。同じ物を撃ち直すと通りました(出典: 社の実測 2026-11-18)。中身を変えずに撃ち直して通るなら、落ちた所が公開の外(取得)にあったと分かります。
拡張から再起動を撃っても、新しい版にならない
VS Code 1.128 で、拡張から「拡張機能の再起動(workbench.action.restartExtensionHost)」を撃っても、前の版のまま立ち上がる(入っている拡張の一覧を読み直さない)事を実測しました。そこで新しい版は、VS Code の拡張機能の画面の[拡張機能の再起動]で入れる形にしています。この形ならエージェントの会話が途切れません(出典: 社の実測 2026-11-15)。公式も、更新の後には拡張の再起動(Restart Extensions)を促すと書いています(出典: Extension Marketplace)。
よくある質問
vsix インストールの後、拡張が自動で新しい版にならないのはなぜ?
.vsix から入れた拡張は、自動更新が既定で切られるためです。Marketplace から入れ直すか、新しい .vsix を入れ直してください。
vsce の publish で同じ版の番号をもう一度出せますか?
出せません。直した物は版の番号を上げて出します。前の版に戻したい時も、前の版の中身を新しい番号で出します。
Open VSX にも出すべきですか?
Cursor など VS Code 互換のエディタの利用者に届けたいなら候補になります。作った .vsix を ovsx の publish に渡して出せますが、出し先が増えるぶん、出たかどうかを確かめる手間も増えます。
workflow が成功なら、公開できたと考えてよいですか?
当社は、それでは足りないと考えています。dry_run のまま成功する事があり、Marketplace の一覧もキャッシュで遅れるので、版が一覧に出たのを見てから「出た」と言います。
出典
- Publishing Extensions — Visual Studio Code(確かめた日 2026-11-20)
- Extension Marketplace — Visual Studio Code(確かめた日 2026-11-20)
- Publishing Extensions — eclipse/openvsx Wiki(確かめた日 2026-11-20)
- 当社の開発の記録(社の実測 2026-09-18〜2026-11-19)