Windowsのシンボリックリンクは、あるパスに置いた参照を通じて、別の場所にあるファイルやフォルダを開けるようにする仕組みで、NTFSとReFSで利用できます。この記事では、コマンドプロンプトのmklinkとPowerShellのNew-Item・Remove-Itemでの作成・確認・削除を、コピーして動かせるコマンド付きで解説します。「十分な特権がありません」「既に存在するファイルを作成することはできません」などのエラーの対処、Cドライブのフォルダを別ドライブへ移す手順、GitやNode.js・Pythonでの扱いも扱います。仕様と版番号は2026年10月24日時点のMicrosoft公式ドキュメントと各プロジェクトの公式文書・ソースコードで確認した値です。
まとめ:Windowsのシンボリックリンク作成コマンドと権限の選択
作り方は、管理者として開いたコマンドプロンプトでmklink リンク名 リンク先を実行するだけです。フォルダなら/Dを付けます。毎回の管理者起動が手間なら、Windowsの開発者モードをオンにすると、一般ユーザーの権限のまま作れるようになります。
ローカルのフォルダを別ドライブへ逃がすだけなら、権限の設定が要らないジャンクション(/J)で足ります。シンボリックリンクを選ぶのは、ファイル単位で張りたい、相対パスでリポジトリに含めたい、ネットワーク共有を指したい、のいずれかに当たるときです。削除はリンクだけをrmdir・del・Remove-Itemで消し、リンク先の実体には触れません。
Windowsのリンク4種類の違いとシンボリックリンクを選ぶ基準
Windowsには「別の場所を指す」仕組みが4つあり、検索で見つかる手順が混ざりやすい原因になっています。最初に違いを押さえます。
シンボリックリンク・ジャンクション・ハードリンク・ショートカットの比較
シンボリックリンク・ジャンクション・ハードリンクはファイルシステムで扱われます。ただし、リンクを検出して拒否したり、コピー時にリンクと実体を区別したりするアプリもあるため、すべてのアプリで同じ動作になるとは限りません。ショートカット(.lnk)はエクスプローラーなどShell Linkに対応したアプリが解釈する普通のファイルで、コマンドや対応していないプログラムからは.lnkファイルそのものに見えます。
| 種類 | 作成コマンド | 対象 | 別ドライブ・共有 | 作成に要る権限 |
|---|---|---|---|---|
| シンボリックリンク | mklink、mklink /D | ファイル・フォルダ | どちらも可 | 管理者か開発者モード |
| ジャンクション | mklink /J | フォルダのみ | 同一・別のローカルボリューム | 不要 |
| ハードリンク | mklink /H | ファイルのみ | 同じドライブ内のみ | 不要 |
| ショートカット | エクスプローラー | ファイル・フォルダ | どちらも可 | 不要 |
ハードリンクは同じファイルに名前を2つ付ける仕組みで、片方を消しても中身は残ります。フォルダを指すシンボリックリンク(/D)とジャンクション(/J)の使い分けは、次の節で整理します。
mklink /Dと/Jの違い:相対パス・ネットワーク・権限の3点
どちらもフォルダを指すリンクですが、違いは3点に集約されます。1点目は権限で、/Dは管理者か開発者モードが必要、/Jは一般ユーザーのまま作れます。2点目はリンク先の範囲です。Microsoftのハードリンクとジャンクションの解説では、ジャンクションは同じPCの別のローカルボリュームまでは指せる一方、Z:\のような割り当て済みネットワークドライブは指せないと例示しています。共有フォルダを指したいなら/Dしかありません。
3点目はパスの記録方法です。ジャンクションはリンク先を絶対パスで記録するため、リンク先ごとフォルダを別の場所へ移すと切れます。PowerShellのNew-Item -ItemType Junctionはリンク先に相対パスを渡すと「Creating a junction requires an absolute path for the target.」で止まります(PowerShell v7.6.0のソースで確認)。シンボリックリンクは相対パスをそのまま記録できるので、リポジトリの中で完結するリンクに向きます。
判断は単純で、自分のPCの中でフォルダを付け替えるだけなら/J、相対パス・ファイル単位・ネットワーク共有のどれかが要るなら/D(ファイルならオプションなし)を選びます。
作成時に固定されるファイル用・ディレクトリ用の種類とNTFSの前提
LinuxやmacOSのシンボリックリンクは、リンク先がファイルかフォルダかを区別しません。Windowsでは作成時に「ファイル用」か「ディレクトリ用」かを決めて記録し、あとから変わりません。CreateSymbolicLinkW関数のリファレンスでも、フラグSYMBOLIC_LINK_FLAG_DIRECTORY(0x1)の有無で種類を指定する仕様です。フォルダを指すのに/Dを付け忘れるとリンクはできても開けず、直すには削除して作り直すしかありません。
もう1つの前提はファイルシステムです。Git for Windowsのシンボリックリンク解説は、シンボリックリンクが動くのはNTFSとReFS(Dev Driveを含む)で、FATとexFATでは使えないと明記しています。USBメモリやSDカードがexFATの場合、その媒体上にはシンボリックリンク自体を作成できません。ここでの制約はリンクを置く側のファイルシステムについてのものです。
mklinkの使い方:作成・確認・削除のコマンド
mklinkはコマンドプロンプトの内部コマンドです。PowerShellから直接は呼べないため、PowerShellで使うときはcmd /c mklink ...の形にします。コマンド操作そのものに慣れていない場合は、CLIの仕組みとGUIとの使い分けの解説を先に読むと手順を追いやすくなります。
管理者のコマンドプロンプトでのmklink構文と/D・/J・/Hの実行例
Microsoft Learnのmklinkリファレンスの構文はmklink [[/d] | [/h] | [/j]] <link> <target>です。引数は「作るリンク名」が先、「リンク先」が後で、Linuxのln -sとは順番が逆になります。リンク先には相対パスと絶対パスのどちらも書けます。
rem ファイルのシンボリックリンク(オプションなし)
mklink C:\work\app\.env C:\secrets\app\.env
rem フォルダのシンボリックリンク(/D)。相対パスはリンクを置く場所が起点
cd C:\work\app
mklink /D shared ..\shared-config
rem フォルダのジャンクション(/J)。管理者権限は不要
mklink /J C:\Users\%USERNAME%\cache D:\cache
rem ハードリンク(/H)。同じドライブ内のファイルのみ
mklink /H C:\work\backup\report.xlsx C:\work\report.xlsx
成功すると「…のシンボリック リンクが作成されました」のように、作った種類が表示されます。パスに空白を含む場合は、リンク名とリンク先の両方を"で囲みます。
dir /ALとfsutil reparsepoint queryでの種類・参照先の確認
作ったリンクは、dirに属性/AL(再解析ポイント)を付けると一覧できます。種類が<SYMLINK>(ファイル)、<SYMLINKD>(フォルダ)、<JUNCTION>で表示され、角かっこの中がリンク先です。
rem カレントフォルダのリンクだけを表示する
dir /AL
rem 表示例
rem 2026/10/24 10:12 <SYMLINKD> shared [..\shared-config]
rem 2026/10/24 10:13 <JUNCTION> cache [D:\cache]
rem 再解析ポイントの中身を確認する
fsutil reparsepoint query C:\work\app\shared
fsutil reparsepoint queryの出力では、タグ値0xa000000cがシンボリックリンク、0xa0000003がジャンクションです(MS-FSCCの再解析タグ一覧のIO_REPARSE_TAG_SYMLINKとIO_REPARSE_TAG_MOUNT_POINT)。エクスプローラーではリンクのアイコンに矢印が付きますが、シンボリックリンクとジャンクションの区別は付かないため、種類の確認はコマンドで行います。
rmdirとdelでリンクだけを消す削除手順とリンク先を消したときの挙動
削除で消えるのはリンクだけで、リンク先の実体は残ります。コマンドはリンクの種類で使い分けます。CreateSymbolicLinkWのリファレンスにも、ファイル用のリンクはファイルとして、ディレクトリ用のリンクはディレクトリとして削除すると書かれています。
rem フォルダのシンボリックリンク・ジャンクションを消す
rmdir C:\work\app\shared
rem ファイルのシンボリックリンク・ハードリンクを消す
del C:\work\app\.env
フォルダのリンクを開いた中でファイルを選んで消すと、リンク先の実体を消してしまいます。削除前にdir /ALでリンクであることを確かめ、オプションなしのrmdirで消す手順を徹底してください。
逆にリンク先のほうを消したり移動したりしても、リンクは自動では消えません。リンクは残ったまま、開こうとすると「指定されたパスが見つかりません」のように失敗する状態になります。こうした壊れたリンクは、後述のPowerShellスクリプトでまとめて探せます。
PowerShellのNew-ItemとRemove-Itemでのリンク操作
PowerShellではNew-Itemで作成、Remove-Itemで削除でき、一覧や検査もスクリプトにしやすくなります。Windows PowerShell 5.1とPowerShell 7系では挙動に差があるので、7系を前提に説明します。2026年10月24日時点の最新版は7.6.8(10月22日公開)です。導入がまだならPowerShell 7.6 LTSのインストール手順を参照してください。
New-Item -ItemType SymbolicLinkの構文と相対パスに対応した版
New-Itemの公式リファレンスでは、ファイルシステム上で-ItemTypeにSymbolicLink・Junction・HardLinkを指定できます。-Targetは-Valueの別名です。
# ファイルへのシンボリックリンク
New-Item -ItemType SymbolicLink -Path .\link.txt -Target .\Notice.txt
# フォルダへのシンボリックリンク(相対パス。Windowsでは7.1以降)
New-Item -ItemType SymbolicLink -Path .\shared -Target ..\shared-config
# ジャンクション(管理者権限は不要。リンク先は絶対パスで、存在している必要がある)
New-Item -ItemType Junction -Path "$env:USERPROFILE\cache" -Target D:\cache
# 作成結果の確認
Get-Item .\shared | Select-Object Name, LinkType, Target
同リファレンスによると、相対パスでの指定は6.2より前では使えず、Windowsでフォルダへの相対パスのシンボリックリンクを作れるのは7.1からです。5.1で相対パスを渡す手順書は動かないことがあるので、社内手順は7系にそろえるか絶対パスで書きます。
同じ名前のリンクが既にあると「Cannot create link because the path already exists」で止まります。-Forceを付けると既存のリンクを消してから作り直し、7.4からは既存のジャンクションも上書きできるようになりました。macOS上のPowerShell 7.6.6で、相対パスのリンク作成と-Forceでの置き換えを実行して確かめています。
Remove-Itemでリンクだけを削除するコマンドと-Recurseの扱い
PowerShellでリンクを消すときもRemove-Itemにリンクのパスを渡すだけです。
# フォルダのシンボリックリンク・ジャンクションを消す(リンク先は残る)
Remove-Item .\shared
# ファイルのリンクも同じ
Remove-Item .\link.txt
# 消したあとにリンク先が残っていることを確かめる
Test-Path ..\shared-config
PowerShell 7.6.0のFileSystemProvider.csでは、削除対象のフォルダがシンボリックリンクやジャンクション(名前サロゲートの再解析ポイント)なら、中へ潜らずリンクそのものだけを外して処理を終えます。-Recurseや-Forceを付けてもこの分岐が先に効くため、リンク先は消えません。macOSのPowerShell 7.6.6でも、Remove-Item -Recurse -Forceでリンクを消したあとにリンク先のファイルが残ることを確認しました。
PowerShell 6.0の変更履歴によると、Remove-Itemがシンボリックリンクに対してリンク自体だけを消す動作になったのは6.0.0-beta.1(#3637)からです。この変更を含まないWindows PowerShell 5.1でフォルダのリンクを消すなら、前章のオプションなしのcmd /c rmdirを使うほうが確実です。
LinkTypeとTargetで壊れたリンクを一括検出するスクリプト
次のスクリプトは、列挙できたシンボリックリンクとジャンクションのうち、リンク先の存在を確認できないものを表示します。アクセス権やネットワーク接続が原因の場合もあるため、結果は壊れたリンクの候補として確認してください。macOSのPowerShell 7.6.6で、リンク先のフォルダを消したリンクが1件だけ表示されることを確認しました。
$root = "C:\work"
Get-ChildItem -Path $root -Recurse -Force -Attributes ReparsePoint -ErrorAction SilentlyContinue |
Where-Object { $_.LinkType -in 'SymbolicLink', 'Junction' } |
ForEach-Object {
$target = @($_.Target)[0]
# 相対パスのリンクは、リンクを置いたフォルダを起点に解決する
if (-not [System.IO.Path]::IsPathRooted($target)) {
$target = Join-Path (Split-Path $_.FullName -Parent) $target
}
[pscustomobject]@{
Link = $_.FullName
Type = $_.LinkType
Target = $target
Exists = Test-Path -LiteralPath $target
}
} |
Where-Object { -not $_.Exists } |
Format-Table -AutoSize
PowerShell 7系のGet-ChildItem -Recurseは、既定ではリンクの先へ潜りません。リンクが自分の親フォルダを指して無限に辿る事故を避けられるので、この既定のまま使います。
mklinkが失敗するときのエラーメッセージ別の対処
mklinkの失敗は、表示されるメッセージで原因を切り分けられます。多いのは次の3つです。
| 表示されるメッセージ | 原因 | 対処 |
|---|---|---|
| この操作を実行するための十分な特権がありません。 | 作成権限がない | 開発者モードか権利の付与 |
| 既に存在するファイルを作成することはできません。 | リンク名が既にある | 既存を移動・削除 |
| ‘mklink’ は…認識されません | PowerShellから実行 | cmd /c mklink |
以下では、各エラーへの対処とネットワーク共有の設定を説明します。
「十分な特権がありません」を開発者モードで解消する手順
管理者でないコマンドプロンプトでmklinkを実行すると、「この操作を実行するための十分な特権がありません。」(英語版では「You do not have sufficient privilege to perform this operation.」)と表示されて失敗します。シンボリックリンクの作成が、既定で管理者にしか許可されていないためです。ジャンクション(/J)で足りる用途なら、権限を変えずにそちらへ切り替えるのが最短です。
Windowsブログの「Symlinks in Windows 10!」(2016年12月2日)によると、Insider Preview build 14972から、開発者モードが有効なら管理者として起動しなくてもシンボリックリンクを作れるようになりました。Git for Windowsの解説は、正式版での対応をWindows 10 バージョン1703(Creators Update)以降としています。
有効化は設定アプリで行います。Microsoftの開発者向け設定の解説によると、スイッチの場所はWindows 11 25H2で変わり、25H2以降は[システム]→[Advanced]ページの「For developers」セクション、それより前の版は独立した「開発者向け」ページです。オンにする操作自体には管理者権限が必要で、組織が管理するPCでは無効化されている場合があります。
rem 管理者のコマンドプロンプトで開発者モードを有効にする(同じ解説にある方法)
reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" /t REG_DWORD /f /v "AllowDevelopmentWithoutDevLicense" /d "1"
開発者モードは「許可」にすぎない点に注意してください。アプリ側がAPI呼び出しでフラグSYMBOLIC_LINK_FLAG_ALLOW_UNPRIVILEGED_CREATE(0x2)を渡さないと、昇格なしの作成は成功しません。古いツールが開発者モードでも失敗するのはこのためです。
ローカルセキュリティポリシーでのシンボリックリンク作成権限の付与
開発者モードを社内規定で使えない場合は、ユーザー権利を個別に付与します。「Create symbolic links」ポリシーの解説によると、権利の定数名はSeCreateSymbolicLinkPrivilegeで、クライアントPCの既定の付与先はAdministratorsグループだけです。
secpol.mscを開く(Home エディションには無いため開発者モードを使う)- [ローカル ポリシー]→[ユーザー権利の割り当て]→[シンボリック リンクの作成]を開く
- 対象のユーザーかグループを追加する
- いったんサインアウトして、サインインし直す
変更に再起動は要らず、対象アカウントが次にサインインしたときから効きます。付与先は管理者でない一般アカウントにします。Git for Windowsの解説のとおり、Administratorsグループのメンバーは権利を付与してもUACの昇格が要るためです。ドメイン環境では、グループポリシーでまとめて配布するほうが管理しやすくなります。
「既に存在するファイルを作成することはできません」とPowerShellで認識されないエラー
「既に存在するファイルを作成することはできません。」は、リンク名に指定したパスに同じ名前のファイルやフォルダが既にあるときに出ます。mklinkには上書きのオプションが無いため、既存のものを別名に変えるか移動してから実行し直します。中身のあるフォルダをリンクに置き換えたい場合は、次の章のフォルダ移動の手順で進めます。
PowerShellのウィンドウでmklinkと打つと、PowerShell 7.6では「The term ‘mklink’ is not recognized as a name of a cmdlet, function, script file, or executable program.」と表示されます(Windows PowerShell 5.1の日本語版では「用語 ‘mklink’ は、コマンドレット…として認識されません」)。mklinkがcmd.exeの内部コマンドで、単独の実行ファイルが無いためです。cmd /c mklink /D shared ..\shared-configのようにcmd /cを前に付けるか、New-Itemに書き換えます。
ネットワーク共有のリンクが開けないときのsymlinkevaluation設定
作成はできても、ファイルサーバー上のリンクを開けないことがあります。原因は、どの経路のシンボリックリンクを辿ってよいかを決めるシステム設定です。fsutil behaviorのリファレンスでは、ローカルからローカル(L2L)、ローカルからリモート(L2R)、リモートからローカル(R2L)、リモートからリモート(R2R)の4経路を個別に許可・禁止できます。Git for Windowsの解説も、リモートのファイルシステム上のリンクは既定で無効だとしています。
rem 現在の設定を確認する(管理者のコマンドプロンプト)
fsutil behavior query symlinkevaluation
rem リモート上のリンクがリモートを指す経路(R2R)を許可する
fsutil behavior set symlinkevaluation R2R:1
リモートからローカルを指す経路(R2L)は、共有フォルダに置かれたリンクが、開いた人のPCのファイルを指すことを意味します。悪用されると利用者のローカルファイルを読ませる経路になるため、業務上の必要が説明できない限り許可しない方針を勧めます。
Cドライブのフォルダを別ドライブへ移すジャンクションの手順
シンボリックリンク・ジャンクションの用途の1つが、アプリが固定のパスに置く大容量のキャッシュやデータを、Cドライブから別ドライブへ移す使い方です。アプリからは元のパスのまま見えるので、設定を変えられないアプリにも効きます。ローカルの別ドライブで済むならジャンクションで足り、管理者権限も開発者モードも要りません。
移行の3手順は、途中で失敗したら止まるようにバッチファイル(例:move-cache.bat)にまとめて実行します。
rem 1. 対象のアプリを終了してから、中身を移動先へコピーする(8以上は失敗)
robocopy "C:\Users\%USERNAME%\cache" "D:\cache" /E /XJ
if errorlevel 8 exit /b 1
rem 2. 元のフォルダを退避名に変える(いきなり消さない)
ren "C:\Users\%USERNAME%\cache" cache.old
if errorlevel 1 exit /b 1
rem 3. 元の場所にジャンクションを作る
mklink /J "C:\Users\%USERNAME%\cache" "D:\cache"
if errorlevel 1 exit /b 1
robocopyのリファレンスでは、/Eは空のフォルダを含むサブフォルダのコピー、/XJは既定ではコピー対象になるジャンクションの除外です。ユーザーフォルダの配下には互換用のジャンクションがあるため、/XJを付けて辿らせないようにします。robocopyの終了コードは8以上なら少なくとも1件の失敗を意味するので、if errorlevel 8で止めています。
退避したフォルダの削除はバッチに含めません。移動先のファイル、/XJで除外したジャンクションの扱い、アプリの動作を確かめてから、次のコマンドを個別に実行します。/Qを付けずに実行し、確認の問い合わせで対象を見直してください。
rem 退避した実フォルダを消す(リンクではなく cache.old に対してだけ使う)
rmdir /S "C:\Users\%USERNAME%\cache.old"
GitやNode.js・Pythonでシンボリックリンクを扱うときの設定とコード
Windowsで困る場面の多くは、手作業ではなく開発ツールがリンクを作るときに起きます。代表的な3つの扱いを示します。
Git for Windowsのcore.symlinks=true設定とリンク復元
LinuxやmacOSで作られたリポジトリにシンボリックリンクが含まれていると、Windowsでクローンしたときに、リンク先のパスが書かれた小さなテキストファイルになることがあります。git-configの公式文書では、core.symlinksの既定はtrueですが、git cloneやgit initが環境を調べて、必要ならfalseに設定すると説明されています。Git for Windowsの解説も、開発者モードが有効な新しいWindows 10以降で無い限り、既定ではリンクを作らないとしています。
# 開発者モードを有効にしたうえで、リンクを有効にしてクローンする
git clone -c core.symlinks=true https://github.com/example/repo.git
# 既存のクローンを直す場合(未コミットの変更が無いことを確認してから)
git config core.symlinks true
git checkout -- .
# リンクとして記録されているファイルを確認する(モード120000がリンク)
git ls-files -s | findstr "^120000"
挙動はmacOSのGit 2.50.1で再現しました。-c core.symlinks=falseでクローンすると、../shared-configを指すリンクは中身が「../shared-config」だけの16バイトのテキストファイルになり、git statusには差分として出ません。気付かないまま使い続けやすいのはこのためです。git config core.symlinks trueのあとgit checkout -- .を実行すると、リンクに戻りました。
Git for Windowsのインストーラーにも「Enable symbolic links」の項目があります。インストーラーの定義ファイルでは、開発者モードが有効でbuild 14972以降の環境などで既定でオンになり、画面には「existing repositories are unaffected by this setting」と表示されます。インストーラーでオンにしても既存のクローンには反映されないため、上の手順で個別に直します。
Git Bashのln -sにも注意が要ります。Git for Windowsの解説によると、既定ではリンクではなくコピーを作るため、Git Bashで張ったつもりのリンクが実体の複製になっていることがあります。リンクはコマンドプロンプトのmklinkかPowerShellのNew-Itemで作ります。Git本体の版の確認と更新はGit for Windows最新版の確認・更新方法にまとめています。
Node.jsのfs.symlinkとPythonのos.symlinkでの種類指定
言語のランタイムからリンクを作る場合も、Windowsで問題になるのはリンクの種類の指定です。Node.jsのfsモジュール文書(2026年10月24日時点の最新はv26.12.1)では、fs.symlinkの第3引数typeはWindowsでのみ有効で、'dir'・'file'・'junction'を指定できます。省略するとリンク先の実体を見て自動判定し、リンク先が無いときは'file'になります。
// Node.js(ESM)
import { symlink } from 'node:fs/promises';
// フォルダへのシンボリックリンク(開発者モードか管理者が必要)
await symlink('../shared-config', './shared', 'dir');
// ジャンクション(権限不要。target は絶対パスへ自動変換される)
await symlink('D:\\cache', 'C:\\work\\cache', 'junction');
# Python 3.8以降
import os
# リンク先がまだ無いフォルダを指すときは target_is_directory=True を明示する
os.symlink(r"..\shared-config", r".\shared", target_is_directory=True)
Pythonのosモジュール文書では、開発者モードによる昇格なしの作成への対応は3.8からで、権限が無い場合はOSErrorになります。target_is_directoryが効くのはリンク先がまだ無いときだけで、リンク先が存在すればその種類に合わせて作られます。pnpmのように依存パッケージをリンクで配置するツールがWindowsで動くのも、この種類の使い分けによります。仕組みはpnpmの共有ストアの仕組みの解説で扱っています。
開発環境でシンボリックリンクを使う場面と使わない場面の判断基準
シンボリックリンクは便利な反面、リンクの存在を知らないツールや人に対しては、見えない依存関係になります。採用と見送りの線引きを示します。
採用する場面:設定ファイルの集約と共有リポジトリのリンク復元
採用してよいのは、リンクの存在を自分か自分のチームが把握できる範囲です。前章のフォルダの別ドライブ退避はジャンクションで済ませ、シンボリックリンクは次の2つに絞ります。1つは複数のプロジェクトで共有する設定ファイルを1か所の実体にまとめる用途です。同じドライブ内ならハードリンクでも作れますが、別ドライブのファイルを指す場合や、パスで参照先を管理したい場合はシンボリックリンクを使います。もう1つはLinuxやmacOSと共有するリポジトリで、既にリンクとして記録されているファイルを正しく復元する用途です。
見送る場面:一般利用者のPCへの権限付与と共有サーバー上のリンク
次の場合は、シンボリックリンクを使わない判断をします。1つ目は、業務アプリの導入手順として一般利用者のPCに作成権限を配ることです。Microsoftのポリシー解説は、この権利を信頼できる利用者だけに与えるよう警告しており、リンクを想定していないアプリの脆弱性につながりうると説明しています。
2つ目は、ファイルサーバーの共有フォルダにリンクを置いて利用者に見せる構成です。前述のsymlinkevaluationの設定が各PCでそろっていないと、開ける人と開けない人が分かれ、問い合わせの原因になります。共有フォルダの付け替えが目的なら、DFS名前空間やドライブの割り当てで解決するほうが運用は安定します。
Windows・Mac・Linux混在チームでリポジトリを設計するときの確認項目
OSが混在する開発チームでは、リポジトリにシンボリックリンクを含めるかどうかを最初に決めておきます。含めるなら、Windowsの開発者全員の開発者モードとcore.symlinksの設定、CIのWindowsランナーでの作成権限とGit設定、相対パスの運用規約を確認します。開発者モードは権利の付与や管理者実行で代替でき、絶対パスのリンクも動作しますが、環境間の移植性を考えると相対パスを推奨します。
モノレポで共有ライブラリをリンクでつなぐ設計は特に影響範囲が広く、モノレポの構成と導入手順で扱う論点と合わせて検討が必要です。一創では、OS混在チームのリポジトリ設計からCIのランナー構成までをDevOps・CI/CD導入支援として請け負っています。
よくある質問
Windowsのシンボリックリンクについて、検索で多い質問に答えます。
シンボリックリンクとショートカットは何が違いますか?
シンボリックリンクはファイルシステムが解決するため、コマンドプロンプトやプログラムから開いてもリンク先の実体として扱われます。ショートカットは.lnk形式のファイルで、エクスプローラーやShell Linkに対応したアプリがリンク先を解決します。プログラムの設定ファイルの場所を付け替えたい場合、ショートカットでは効果がありません。
シンボリックリンクを削除するとリンク先のファイルも消えますか?
リンクだけを削除すれば、リンク先の実体は残ります。フォルダのリンクはオプションなしのrmdir、ファイルのリンクはdel、PowerShell 7系ならRemove-Itemで消してください。エクスプローラーでリンクのアイコンを選んで削除しても消えるのはリンクだけですが、リンクを開いた中のファイルを選んで消すと、それはリンク先の実体を消す操作になります。
エクスプローラーの操作だけでシンボリックリンクを作れますか?
Windows標準のエクスプローラーには、シンボリックリンクを作るメニューがありません。作成はコマンドプロンプトのmklinkか、PowerShellのNew-Itemで行います。ショートカットの作成メニューはありますが、最初の質問のとおり別の仕組みです。
作ったシンボリックリンクのリンク先を後から変更できますか?
mklinkにはリンク先を書き換えるオプションがないため、いったん削除して作り直します。PowerShellならNew-Item -Forceで既存のリンクを消して作り直せます。どちらの方法でも、リンクの種類(ファイル用かディレクトリ用か)を作り直しの際に正しく指定してください。
WSLのLinuxからWindows側のフォルダへリンクを張れますか?
WSLのLinux側ではln -sでリンクを作れますが、その扱いはLinuxのファイルシステム上か/mnt/c配下かで変わります。Windowsのアプリからも開けるリンクが必要なら、Windows側でmklinkを使って作るほうが確実です。WSLの開発環境づくりはWSLで開発環境を構築する手順で解説しています。