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 に出す手順

順やる事コマンド・画面
1vsce を入れる(Node.js が要る)npm install -g @vscode/vsce
2Azure DevOps で PAT を作るOrganization は All accessible organizations、Scopes は Custom defined で Marketplace の Manage
3publisher を作るMarketplace の管理の画面で[Create publisher]。ID は後から変えられない
4PAT で 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 MarketplaceOpen VSX
公開の道具vsce の publishovsx の publish -p <token>(作った .vsix を渡すなら ovsx の publish <file> -p <token>)
前に要る物Azure DevOps の PAT と publishereclipse.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.751.3.75 の中身
戻すために出す版1.3.761.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 の一覧もキャッシュで遅れるので、版が一覧に出たのを見てから「出た」と言います。

出典

  1. Publishing Extensions — Visual Studio Code(確かめた日 2026-11-20)
  2. Extension Marketplace — Visual Studio Code(確かめた日 2026-11-20)
  3. Publishing Extensions — eclipse/openvsx Wiki(確かめた日 2026-11-20)
  4. 当社の開発の記録(社の実測 2026-09-18〜2026-11-19)